Skip to content

Customer event
Webhook

Request

Sent to your registered URL when a subscribed customer event occurs (CUSTOMER_CREATE, CUSTOMER_UPDATE).

Respond with HTTP 200 within 10 seconds to acknowledge receipt. Return 422 to intentionally reject the resource; any other error triggers up to 3 retries before the webhook is suspended.

Security
bearerAuth
Bodyapplication/jsonrequired
event_typestringrequired

The event that triggered the notification, in RESOURCE_ACTION form.

Example:"CUSTOMER_CREATE"
resource_idintegerrequired

Identifier of the affected resource.

Example:789
timestampstring, (date-time)required

When the event occurred (RFC 3339).

Example:"2026-09-11T14:30:00+02:00"
Payload
{
  "event_type": "CUSTOMER_CREATE",
  "resource_id": 789,
  "timestamp": "2026-09-11T14:30:00+02:00"
}

Responses

Event acknowledged.