customer.updated

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.updated",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "customer_id": "cust_1a2b3c4d5e6f",
    "email": "jane@example.com",
    "name": "Jane Doe",
    "phone_number": "+2348012345678",
    "metadata": {},
    "billing_address": {
      "line1": "40 Yaba Road",
      "line2": null,
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "101245",
      "country": "NG"
    },
    "created_at": "2026-04-27T12:00:00Z",
    "updated_at": "2026-04-27T12:00:00Z"
  }
}

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.updated",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "customer_id": "cust_1a2b3c4d5e6f",
    "email": "jane@example.com",
    "name": "Jane Doe",
    "phone_number": "+2348012345678",
    "metadata": {},
    "billing_address": {
      "line1": "40 Yaba Road",
      "line2": null,
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "101245",
      "country": "NG"
    },
    "created_at": "2026-04-27T12:00:00Z",
    "updated_at": "2026-04-27T12:00:00Z"
  }
}

Sent when a customer is updated. Use it to keep your copy of the customer in sync. Creating a customer with an email that already exists returns the existing customer with your changes applied, so that call emits customer.updated rather than customer.created.

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "customer.updated",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "customer_id": "cust_1a2b3c4d5e6f",
    "email": "jane@example.com",
    "name": "Jane Doe",
    "phone_number": "+2348012345678",
    "metadata": {},
    "billing_address": {
      "line1": "40 Yaba Road",
      "line2": null,
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "101245",
      "country": "NG"
    },
    "created_at": "2026-04-27T12:00:00Z",
    "updated_at": "2026-04-27T12:00:00Z"
  }
}

Event fields

string

The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.

string

Always customer.updated.

string

When the event occurred, in UTC.

string

Your account’s ID.

string

The customer’s ID, prefixed cust_.

string

The customer’s email address.

string | null

The customer’s name.

string | null

The customer’s phone number in E.164 format.

object

Your own key-value data on the customer.

object | null

The customer’s billing address: line1, line2, city, state, postal_code, and country (ISO-3166-1 alpha-2). null when no address is stored. Sent whenever an update changes it.

string

When the customer was created, in UTC.

string

When the customer was last updated, in UTC.

Concepts

Events

Endpoint API

customer.updated

Event fields

​Event fields

Event fields