Webhooks

contact_updated

A contact row changed. Fires on every update — including bulk edits and enrichment, which can mean a very large number of events at once. Make your handler idempotent and cheap, or subscribe to the narrower stage_changed and score_changed events instead.

postWebhookcontact_updated

Payload

eventstring

Event type. Also sent in the X-Webhook-Event header.

timestampstring date-time

When the event was delivered — not necessarily when it occurred.

webhook_idstring uuid

Delivery ID. Also sent as X-Webhook-ID. Use it to deduplicate retries.

organization_idstring uuid

Example payload

{
  "event": "contact_created"
}

Response

Return any 2xx to acknowledge. A non-2xx or a timeout is treated as a failed delivery and retried with backoff up to your configured max_retries.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.