Webhook-Ereignisse

Ereignisnamen haben die Form resource.event, mit einem Verb in der Vergangenheit. Um ein Ereignis zu abonnieren, braucht dein Schlüssel das Recht aus der Tabelle. Ereignisse mit bald verfügbar stehen in der Liste, damit du planen kannst; ein Endpunkt kann sie noch nicht abonnieren und die API antwortet mit validation_failed.

Der Status in der Tabelle gilt für heute: verfügbar heißt, SmartChat sendet das Ereignis jetzt, bald verfügbar heißt, dass es noch nichts sendet.

Jeder Body hat denselben Umschlag. Siehe Webhooks. Manche Ereignisse fügen Felder in data neben object hinzu: contact.updated hat previous_attributes und changed_fields, contact.tag_removed hat tag, contact.opted_out hat reason und message.failed hat failure_code.

Wenn du einen Endpunkt anlegst, bedeutet ["*"] alle verfügbaren Ereignisse (nie webhook.test). webhook.test braucht nur das Recht webhooks:write.

Event	When it happens	Permission to subscribe	Status
`contact.created`	A contact was created.	`contacts:read`	available
`contact.updated`	Name, email, phone number or tags of a contact changed (see changed_fields).	`contacts:read`	coming soon (cannot be subscribed to yet)
`contact.deleted`	A contact was deleted. Only id and deleted_at are sent.	`contacts:read`	coming soon (cannot be subscribed to yet)
`contact.tag_removed`	A tag was removed from a contact (see tag).	`contacts:read`	coming soon (cannot be subscribed to yet)
`contact.opted_in`	A contact confirmed the WhatsApp opt-in.	`contacts:read`	coming soon (cannot be subscribed to yet)
`contact.opted_out`	A contact unsubscribed (see reason).	`contacts:read`	coming soon (cannot be subscribed to yet)
`conversation.created`	A new conversation started.	`inbox:read`	available
`conversation.handover_requested`	The AI handed a conversation over to a human.	`inbox:read`	coming soon (cannot be subscribed to yet)
`message.received`	An incoming message arrived.	`inbox:read`	available
`message.sent`	An outgoing message was sent to WhatsApp.	`inbox:read`	coming soon (cannot be subscribed to yet)
`message.delivered`	An outgoing message was delivered.	`inbox:read`	coming soon (cannot be subscribed to yet)
`message.read`	An outgoing message was read.	`inbox:read`	coming soon (cannot be subscribed to yet)
`message.failed`	An outgoing message failed (see failure_code).	`inbox:read`	coming soon (cannot be subscribed to yet)
`send.completed`	A send created through the API completed.	`sends:read`	coming soon (cannot be subscribed to yet)
`send.failed`	A send created through the API failed.	`sends:read`	coming soon (cannot be subscribed to yet)
`template.status_changed`	The WhatsApp approval status of a template changed.	`templates:read`	coming soon (cannot be subscribed to yet)
`newsletter.scheduled`	A newsletter was scheduled.	`newsletters:read`	coming soon (cannot be subscribed to yet)
`newsletter.started`	Sending of a newsletter started.	`newsletters:read`	coming soon (cannot be subscribed to yet)
`newsletter.completed`	Sending of a newsletter completed.	`newsletters:read`	coming soon (cannot be subscribed to yet)
`newsletter.failed`	Sending of a newsletter failed.	`newsletters:read`	coming soon (cannot be subscribed to yet)
`automation.run_failed`	An automation run failed.	`automations:read`	coming soon (cannot be subscribed to yet)
`account.limit_reached`	The monthly message quota or the credits of the account are used up. Not about API keys: a key has no usage limit.	`account:read`	coming soon (cannot be subscribed to yet)
`account.limit_warning`	The monthly message quota or the credits of the account are at 80 percent. Not about API keys: a key has no usage limit.	`account:read`	coming soon (cannot be subscribed to yet)
`webhook.test`	Test ping sent on request to an endpoint.	`webhooks:write`	available

#contact.created

A contact was created. Object in data.object: contact. Permission to subscribe: contacts:read. Status: available.

{
  "id": "evt_000000000000000000000000000000e0",
  "object": "event",
  "type": "contact.created",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:07.412Z",
  "sequence": 128734,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "name": "Mia Muster",
      "phone": "+4915112345678",
      "email": "mia@example.com",
      "tags": [
        "regular customer"
      ],
      "optin_whatsapp": "none",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#contact.updated

Name, email, phone number or tags of a contact changed (see changed_fields). Object in data.object: contact. Permission to subscribe: contacts:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e1",
  "object": "event",
  "type": "contact.updated",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:08.412Z",
  "sequence": 128735,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "name": "Mia Muster-Berg",
      "phone": "+4915112345678",
      "email": "mia@example.com",
      "tags": [
        "regular customer"
      ],
      "optin_whatsapp": "none",
      "created_at": "2026-10-25T09:41:07Z"
    },
    "previous_attributes": {
      "name": "Mia Muster"
    },
    "changed_fields": [
      "name"
    ]
  }
}

#contact.deleted

A contact was deleted. Only id and deleted_at are sent. Object in data.object: contact. Permission to subscribe: contacts:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e2",
  "object": "event",
  "type": "contact.deleted",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:09.412Z",
  "sequence": 128736,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "deleted_at": "2026-10-25T09:41:07Z"
    }
  }
}

#contact.tag_removed

A tag was removed from a contact (see tag). Object in data.object: contact. Permission to subscribe: contacts:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e3",
  "object": "event",
  "type": "contact.tag_removed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:10.412Z",
  "sequence": 128737,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "name": "Mia Muster",
      "phone": "+4915112345678",
      "email": "mia@example.com",
      "tags": [],
      "optin_whatsapp": "none",
      "created_at": "2026-10-25T09:41:07Z"
    },
    "tag": "regular customer"
  }
}

#contact.opted_in

A contact confirmed the WhatsApp opt-in. Object in data.object: contact. Permission to subscribe: contacts:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e4",
  "object": "event",
  "type": "contact.opted_in",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:11.412Z",
  "sequence": 128738,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "name": "Mia Muster",
      "phone": "+4915112345678",
      "email": "mia@example.com",
      "tags": [
        "regular customer"
      ],
      "optin_whatsapp": "confirmed",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#contact.opted_out

A contact unsubscribed (see reason). Object in data.object: contact. Permission to subscribe: contacts:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e5",
  "object": "event",
  "type": "contact.opted_out",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:12.412Z",
  "sequence": 128739,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "contact",
      "id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "name": "Mia Muster",
      "phone": "+4915112345678",
      "email": "mia@example.com",
      "tags": [
        "regular customer"
      ],
      "optin_whatsapp": "opted_out",
      "created_at": "2026-10-25T09:41:07Z"
    },
    "previous_attributes": {
      "optin_whatsapp": "confirmed"
    },
    "reason": "stop_keyword"
  }
}

#conversation.created

A new conversation started. Object in data.object: conversation. Permission to subscribe: inbox:read. Status: available.

{
  "id": "evt_000000000000000000000000000000e6",
  "object": "event",
  "type": "conversation.created",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:13.412Z",
  "sequence": 128740,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "conversation",
      "id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "channel": "whatsapp",
      "window_expires_at": "2026-10-26T09:41:07Z",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#conversation.handover_requested

The AI handed a conversation over to a human. Object in data.object: conversation. Permission to subscribe: inbox:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e7",
  "object": "event",
  "type": "conversation.handover_requested",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:14.412Z",
  "sequence": 128741,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "conversation",
      "id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "channel": "whatsapp",
      "window_expires_at": "2026-10-26T09:41:07Z",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#message.received

An incoming message arrived. Object in data.object: message. Permission to subscribe: inbox:read. Status: available.

{
  "id": "evt_000000000000000000000000000000e8",
  "object": "event",
  "type": "message.received",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:15.412Z",
  "sequence": 128742,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "message",
      "id": "msg_0f8c1a2e4b7d4c3e9a5b6d7e8f909999",
      "conversation_id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "direction": "inbound",
      "text": "Hello, do you have a table for two?",
      "status": "received",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#message.sent

An outgoing message was sent to WhatsApp. Object in data.object: message. Permission to subscribe: inbox:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000e9",
  "object": "event",
  "type": "message.sent",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:16.412Z",
  "sequence": 128743,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "message",
      "id": "msg_0f8c1a2e4b7d4c3e9a5b6d7e8f909999",
      "conversation_id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "direction": "outbound",
      "text": "Your table is booked for 7 pm.",
      "status": "sent",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#message.delivered

An outgoing message was delivered. Object in data.object: message. Permission to subscribe: inbox:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000ea",
  "object": "event",
  "type": "message.delivered",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:17.412Z",
  "sequence": 128744,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "message",
      "id": "msg_0f8c1a2e4b7d4c3e9a5b6d7e8f909999",
      "conversation_id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "direction": "outbound",
      "text": "Your table is booked for 7 pm.",
      "status": "delivered",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#message.read

An outgoing message was read. Object in data.object: message. Permission to subscribe: inbox:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000eb",
  "object": "event",
  "type": "message.read",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:18.412Z",
  "sequence": 128745,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "message",
      "id": "msg_0f8c1a2e4b7d4c3e9a5b6d7e8f909999",
      "conversation_id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "direction": "outbound",
      "text": "Your table is booked for 7 pm.",
      "status": "read",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#message.failed

An outgoing message failed (see failure_code). Object in data.object: message. Permission to subscribe: inbox:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000ec",
  "object": "event",
  "type": "message.failed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:19.412Z",
  "sequence": 128746,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "message",
      "id": "msg_0f8c1a2e4b7d4c3e9a5b6d7e8f909999",
      "conversation_id": "cnv_0f8c1a2e4b7d4c3e9a5b6d7e8f905678",
      "contact_id": "con_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
      "direction": "outbound",
      "text": "Your table is booked for 7 pm.",
      "status": "failed",
      "created_at": "2026-10-25T09:41:07Z"
    },
    "failure_code": "window_closed"
  }
}

#send.completed

A send created through the API completed. Object in data.object: send. Permission to subscribe: sends:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000ed",
  "object": "event",
  "type": "send.completed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:20.412Z",
  "sequence": 128747,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "send",
      "id": "snd_00000000000000000000000000000051",
      "status": "completed",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#send.failed

A send created through the API failed. Object in data.object: send. Permission to subscribe: sends:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000ee",
  "object": "event",
  "type": "send.failed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:21.412Z",
  "sequence": 128748,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "send",
      "id": "snd_00000000000000000000000000000052",
      "status": "failed",
      "created_at": "2026-10-25T09:41:07Z"
    }
  }
}

#template.status_changed

The WhatsApp approval status of a template changed. Object in data.object: template. Permission to subscribe: templates:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000ef",
  "object": "event",
  "type": "template.status_changed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:22.412Z",
  "sequence": 128749,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "template",
      "id": "tpl_00000000000000000000000000000061",
      "status": "approved"
    }
  }
}

A newsletter was scheduled. Object in data.object: newsletter. Permission to subscribe: newsletters:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f0",
  "object": "event",
  "type": "newsletter.scheduled",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:23.412Z",
  "sequence": 128750,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "newsletter",
      "id": "nwl_00000000000000000000000000000071",
      "status": "scheduled"
    }
  }
}

Sending of a newsletter started. Object in data.object: newsletter. Permission to subscribe: newsletters:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f1",
  "object": "event",
  "type": "newsletter.started",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:24.412Z",
  "sequence": 128751,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "newsletter",
      "id": "nwl_00000000000000000000000000000072",
      "status": "sending"
    }
  }
}

Sending of a newsletter completed. Object in data.object: newsletter. Permission to subscribe: newsletters:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f2",
  "object": "event",
  "type": "newsletter.completed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:25.412Z",
  "sequence": 128752,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "newsletter",
      "id": "nwl_00000000000000000000000000000073",
      "status": "completed"
    }
  }
}

Sending of a newsletter failed. Object in data.object: newsletter. Permission to subscribe: newsletters:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f3",
  "object": "event",
  "type": "newsletter.failed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:26.412Z",
  "sequence": 128753,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "newsletter",
      "id": "nwl_00000000000000000000000000000074",
      "status": "failed"
    }
  }
}

#automation.run_failed

An automation run failed. Object in data.object: automation_run. Permission to subscribe: automations:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f4",
  "object": "event",
  "type": "automation.run_failed",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:27.412Z",
  "sequence": 128754,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "automation_run",
      "id": "run_00000000000000000000000000000081",
      "automation_id": "aut_00000000000000000000000000000082",
      "status": "failed"
    }
  }
}

#account.limit_reached

The monthly message quota or the credits of the account are used up. Not about API keys: a key has no usage limit. Object in data.object: account. Permission to subscribe: account:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f5",
  "object": "event",
  "type": "account.limit_reached",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:28.412Z",
  "sequence": 128755,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "account",
      "id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234"
    }
  }
}

#account.limit_warning

The monthly message quota or the credits of the account are at 80 percent. Not about API keys: a key has no usage limit. Object in data.object: account. Permission to subscribe: account:read. Status: coming soon. It is listed so that you can plan, but an endpoint cannot subscribe to it yet. The example shows the planned shape and can still change.

{
  "id": "evt_000000000000000000000000000000f6",
  "object": "event",
  "type": "account.limit_warning",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:29.412Z",
  "sequence": 128756,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "account",
      "id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234"
    }
  }
}

#webhook.test

Test ping sent on request to an endpoint. Object in data.object: webhook_test. Permission to subscribe: webhooks:write. Status: available.

{
  "id": "evt_000000000000000000000000000000f7",
  "object": "event",
  "type": "webhook.test",
  "api_version": "2026-10-25",
  "created_at": "2026-10-25T09:41:30.412Z",
  "sequence": 128757,
  "account_id": "acc_0f8c1a2e4b7d4c3e9a5b6d7e8f901234",
  "livemode": true,
  "request_id": "req_01JAB9C3X7K2M4N5P6Q7R8S9T0",
  "data": {
    "object": {
      "object": "webhook_test",
      "id": "whe_00000000000000000000000000000091"
    }
  }
}