~/docs/webhooks / events / message.created

message.created

Fired when a new message is added to a chat session.


This event is triggered immediately when a new message is inserted into a chat, whether it is from a user or generated by the AI assistant. For AI messages, this represents the start of the generation process (status: pending).

Payload

json
{
  "event": "message.created",
  "timestamp": "2026-06-13T17:37:50.539Z",
  "data": {
    "id": "msg_123abc",
    "chatId": "5620d1c6-b394-405c-9608-6ade631f98f2",
    "role": "assistant",
    "status": "pending",
    "content": "",
    "reasoning": null,
    "toolCalls": [],
    "toolResults": [],
    "attachments": [],
    "createdAt": "2026-06-13T17:37:50.539Z",
    "updatedAt": "2026-06-13T17:37:50.539Z"
  }
}