Webhook Events

Contact field events

  • contact.field_changed: A custom field on a contact was set, changed, or cleared; bulk contact imports emit no contact events.

Delivered as a POST to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by id.

postWebhookcontactFieldEvents

Payload

idstring required

Event id (evt_…). Stable across automatic retries and manual redeliveries; deduplicate on it.

type'contact.field_changed' required
apiVersionstring required

Payload version.

createdAtstring date-time required

When the event was created.

Example payload

{
  "apiVersion": "2026-08-06"
}

Response

Acknowledges the delivery. Any other status, or no response within 10 seconds, schedules a retry.

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.