customer.updated
Triggered when a customer's details change, such as the name, email, external id, address or currency.
X-Clocknext-Signature*stringt=<unix seconds>,v1=<hex HMAC-SHA256> — the HMAC of ${t}.${rawBody} keyed with the endpoint's signing secret. See Verify the signature.
X-Clocknext-Event-Id*stringThe event's id — the same as id in the body, and the same on every retry.
X-Clocknext-Event-Type*stringThe event name — the same as event_type in the body.
application/json- body
id*stringevt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates.
event_type*stringAlways customer.updated.
triggered_at*stringWhen the event was triggered (ISO 8601).
date-timedata*The customer, as it is after the change, and the fields that changed.
Answer any 2xx within 5 seconds; the body is ignored. Anything else counts as failed and is retried.
{ "id": "evt_7582a64f35ed367bc274731c771ceaf7", "event_type": "customer.updated", "triggered_at": "2026-10-07T10:12:44.530Z", "data": { "customer": { "id": "cus_abc123", "name": "Acme Corp", "external_id": "acme-42", "email": "billing@acme.com", "currency_code": "inr", "status": "ACTIVE", "created_at": "2026-10-01T08:00:00.000Z" }, "updated_fields": [ "name", "email" ] }}{ "X-Clocknext-Signature": "t=1791367200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd", "X-Clocknext-Event-Id": "evt_7582a64f35ed367bc274731c771ceaf7", "X-Clocknext-Event-Type": "customer.updated"}Types
Every object type on this page, with its fields.
CustomerUpdatedEvent
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | evt_ + 32 hex characters. Unique per event, and the same on every retry of it — use it to skip duplicates. |
event_type | string | yes | Always customer.updated. |
triggered_at | string | yes | When the event was triggered (ISO 8601). |
data | CustomerUpdatedData | yes | The customer, as it is after the change, and the fields that changed. |
CustomerUpdatedData
The data object of a customer.updated event: the customer, as it is after the change, and the names of the fields that changed.
| Field | Type | Required | Description |
|---|---|---|---|
customer | WebhookCustomerDetails | yes | The customer the event is about, as it is after the change. |
updated_fields | "name" | "external_id" | "email" | "phone" | "website" | "description" | "legal_name" | "address_line1" | "city" | "state" | "country" | "pincode" | "tax_id" | "currency_code" | "logo_url"[] | yes | The fields that changed, in snake_case. A save that changes none of them sends no event. |
WebhookCustomerDetails
The customer the event is about, as it is after the change.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | The customer's Clocknext id. |
name | string | yes | The customer's name. |
external_id | string | null | yes | Your own id for the customer. Null when none is set. |
email | string | null | yes | The customer's email. Null when none is set. |
currency_code | string | yes | The customer's currency, lowercase (ISO 4217) — what they pay in at checkout. |
status | "ACTIVE" | "ARCHIVED" | yes | ARCHIVED once the customer is archived, else ACTIVE. |
created_at | string | yes | When the customer was added (ISO 8601). |