Webhook events · contacts
contact.updated/1
Contact updated. A contact changed. `changed_fields` lists which fields (names only).
Payload
We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.
| Field | Type | What it is |
|---|---|---|
| idrequired | string | Event id. The same on every retry: use it to skip duplicates.pattern ^evt_[0-9A-HJKMNP-TV-Z]{26}$ |
| typerequired | string | Event type.always contact.updated |
| versionrequired | string | Payload version.always 1 |
| api_versionrequired | string | The endpoint's API version. |
| occurred_atrequired | string | When it happened.date-time |
| company_idrequired | integer | Your workspace id. |
| datarequired | object | |
| idrequired | integer | Contact id. |
| company_idrequired | integer | Workspace id. |
| name | string or null | Name. |
| phone_number | string or null | Phone, digits only. |
| custom_identifier | string or null | Your own id, if set. |
| source | string or null | How it was created.one of: manual, api, import |
| created_at | string or null | ISO 8601. |
| updated_at | string or null | ISO 8601. |
| changed_fieldsrequired | array of string | Changed field names. |
Example
{
"id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
"type": "contact.updated",
"version": "1",
"api_version": "2026-10-01",
"occurred_at": "2026-09-24T09:20:00Z",
"company_id": 1001,
"data": {
"id": 48213,
"company_id": 1001,
"name": "Jane Doe",
"phone_number": "15555550123",
"custom_identifier": null,
"source": "api",
"created_at": "2026-09-23T03:02:10Z",
"updated_at": "2026-09-23T03:02:10Z",
"changed_fields": [
"name"
]
}
}Headers
Webhook-Signature:t=…,v1=…— how to check itWebhook-Id(alsoWebhook-Event-Id): the event id, the same on every retry — skip ones you have handledWebhook-Delivery-Id: this delivery attempt, new on every try