Skip to main content
WEBHOOK

Headers

webhook-id
string
required

Stable event ID; unchanged across retries.

webhook-timestamp
integer
required

Unix seconds when this delivery attempt was signed.

webhook-signature
string
required

Space-separated Standard Webhooks signatures such as v1,<base64>.

Body

application/json
event_id
string
required

Deduplicate on this — delivery is at least once.

Example:

"evt_01JZE9M2XW"

event_type
enum<string>
required
Available options:
message.received,
message.edited,
message.unsent,
conversation.added,
conversation.updated,
conversation.removed,
reaction.added,
reaction.removed,
message.delivered,
message.read,
group.invite.joined,
group.invite.declined,
group.invite.completed,
group.invite.expired
Example:

"message.received"

agent_id
string
required
Example:

"agt_01JZRELAY"

created_at
string<date-time>
required
data
object
required

Response

204

Event accepted.