conversation.created/1

Conversation started. A new conversation was opened (usually the first message from a customer).

Payload

We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.

Payload fields
Field	Type	What it is
idrequired	string	Event id. The same on every retry: use it to skip duplicates.pattern `^evt_[0-9A-HJKMNP-TV-Z]{26}$`
typerequired	string	Event type.always `conversation.created`
versionrequired	string	Payload version.always `1`
api_versionrequired	string	The endpoint's API version.
occurred_atrequired	string	When it happened.date-time
company_idrequired	integer	Your workspace id.
datarequired	object
idrequired	integer	Conversation id.
company_idrequired	integer	Workspace id.
contact	object or null	The contact.
idrequired	integer	Id.
namerequired	string or null	Name.
channel	object or null	The channel.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_staff	object or null	Assigned staff member.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_team	object or null	Assigned team.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_at	string or null	ISO 8601.
created_at	string or null	ISO 8601.

Example

{
  "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
  "type": "conversation.created",
  "version": "1",
  "api_version": "2026-10-01",
  "occurred_at": "2026-09-24T09:20:00Z",
  "company_id": 1001,
  "data": {
    "id": 77410,
    "company_id": 1001,
    "contact": {
      "id": 48213,
      "name": "Jane Doe"
    },
    "channel": {
      "id": 301,
      "name": "Main WhatsApp"
    },
    "assigned_staff": null,
    "assigned_team": null,
    "assigned_at": null,
    "created_at": "2026-09-24T09:11:40Z"
  }
}

Headers

Webhook-Signature: t=…,v1=… — how to check it
Webhook-Id (also Webhook-Event-Id): the event id, the same on every retry — skip ones you have handled
Webhook-Delivery-Id: this delivery attempt, new on every try