Skip to main content
WEBHOOK
customer.updated
{
  "eventId": "b3a2d5c4-1f2e-4a6b-9c7d-1234567890ab",
  "type": "<string>",
  "occurredAt": "2023-11-07T05:31:56Z",
  "data": {
    "customerId": "<string>",
    "customerType": "CONSUMER",
    "name": "<string>",
    "identity": "<string>",
    "preferredLocale": "en-US",
    "humanReadableId": "29A-BY3Z-X78",
    "contact": {
      "email": "jsmith@example.com",
      "msisdn": "<string>"
    },
    "billing": {
      "method": "EMAIL_INVOICE",
      "email": "billing@company.com",
      "address": {
        "street1": "500 S Main St",
        "street2": "Apt 1",
        "city": "Natick",
        "zip": "01701",
        "country": "US",
        "state": "CA",
        "region": "<string>",
        "attention": "<string>"
      },
      "currency": "USD",
      "defaultPaymentProfileId": "c1d2e3f4-a5b6-7890-1234-901234567890",
      "autoPay": true
    },
    "users": [
      {
        "userId": "<string>",
        "name": "<string>",
        "role": "MEMBER"
      }
    ],
    "contactPersonUserId": "<string>",
    "contactPerson": {
      "userId": "<string>",
      "name": "<string>",
      "role": "MEMBER"
    },
    "shipping": {
      "name": "John Doe",
      "msisdn": "+15551234567",
      "address": {
        "street1": "500 S Main St",
        "street2": "Apt 1",
        "city": "Natick",
        "zip": "01701",
        "country": "US",
        "state": "CA",
        "region": "<string>",
        "attention": "<string>"
      },
      "instructions": "Leave at front door"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Body

application/json
​
eventId
string<uuid>
required

Unique identifier for this event (stable for the logical event; multiple delivery attempts reuse the same id). Use for idempotency.

Example:

"b3a2d5c4-1f2e-4a6b-9c7d-1234567890ab"

​
type
string
required

Event type identifier (dot namespaced, e.g. subscription.created). The event type identifier.

Allowed value: "customer.updated"
​
occurredAt
string<date-time>
required

RFC 3339 timestamp when the underlying change occurred.

​
data
object
required

Customer snapshot at the time of this event. Event-specific payload; structure depends on event type.

Response

Acknowledged

⌘I