Webhooks and APIOutbound
chat.created
Emitted when a new chat is created from a first-contact channel event
A chat is one channel thread inside a conversation, not the top-level inbox unit. A contact who writes on WhatsApp and Telegram has one conversation with two chats. ChatPayload.conversationId tells you which conversation this thread belongs to.
type: chat.created
Fired when Wexio creates a new chat, the first time a contact reaches you through a channel.
When it fires
- A WhatsApp, Telegram, Viber or Instagram contact messages a connected integration for the first time.
- A website visitor starts a chat.
- A contact reaches you on a channel they had not used before, which opens a new thread.
Not fired for subsequent messages in an existing chat - those are covered by message.inbound.created and message.outbound.created.
data shape
type Data = {
chat: ChatPayload;
contact?: ContactPayload; // The chat's primary contact, when resolvable
};chat- always present. SeeChatPayload.contact- present when the chat has a resolvable primary contact. SeeContactPayload.
Example envelope
{
"id": "evt_2a3f1d4c-9b2e-4e7a-9c8d-bd8e9a0e4c10",
"type": "chat.created",
"timestamp": "2026-04-24T14:02:10.123Z",
"data": {
"chat": {
"id": "6804f4c2a6f9f35f6e66f1a1",
"integrationId": "67f95b0126a4d1c9e3f0aa12",
"channel": "WHATSAPP",
"externalChatId": "wa_99887766",
"whatsappId": "wa_99887766",
"firstName": "Alex",
"lastName": "Stone",
"createdAt": "2026-04-24T14:02:10.000Z",
"updatedAt": "2026-04-24T14:02:10.000Z"
},
"contact": {
"peopleId": "6804f4d5a6f9f35f6e66f1a2",
"phoneNumber": "+46700000000",
"firstName": "Alex",
"lastName": "Stone",
"createdAt": "2026-04-24T14:02:10.000Z",
"updatedAt": "2026-04-24T14:02:10.000Z"
}
},
"meta": {
"eventId": "evt_2a3f1d4c-9b2e-4e7a-9c8d-bd8e9a0e4c10",
"event": "chat.created",
"occurredAt": "2026-04-24T14:02:10.123Z",
"organisationId": "6640f3d5c8a0d7e8b7f20222",
"connectionId": "6640f45ac8a0d7e8b7f2014a",
"apiVersion": "2026-04-01",
"attempt": 1
}
}Related
chat.updated- consumer-visible field changeschat.deleted- removed with its contact- Shared Types -
ChatPayload,ContactPayload - Envelope & Delivery - headers, signing, retry policy