Conversations events

Outbound webhook events for conversations: when each one fires and the exact JSON payload Centerfy POSTs to your URL.

1 event. Subscribe to them in Settings → API & Webhooks → Webhooks or with the outbound webhook subscription endpoints. Delivery, authentication headers and the common envelope are described in the webhooks overview.

Event	When it fires
`conversation.created`	A new conversation thread starts with a contact on any channel.

conversation.created

Conversation created. A new conversation thread starts with a contact on any channel.

{
  "event": "conversation.created",
  "occurred_at": "2026-06-20T14:30:00.000Z",
  "sub_account_id": "<sub account uuid>",
  "organization_id": "<organization uuid>",
  "conversation": {
    "id": "<uuid>",
    "contact_id": "<uuid>",
    "contact_name": "Jane Doe",
    "contact_email": "[email protected]",
    "contact_phone": "+14155550123",
    "platform": "sms",
    "status": "open",
    "created_at": "2026-06-20T14:30:00.000Z"
  }
}