Customer events

What data you get for customer.created, .updated, .deleted, and customer.tax_id.created/.updated/.deleted.

Fires when a customer, or their tax ID, is created, updated, or deleted.

Prop

Type

{
  "id": "cus_01J9ABCDEFGHJKMNPQRSTV",
  "object": "customer",
  "name": "Somchai Jaidee",
  "email": "somchai@example.com",
  "phone": "+66812345678",
  "address": {
    "city": "Bangkok",
    "country": "TH",
    "line1": "123 Sukhumvit Rd",
    "postal_code": "10110"
  },
  "capabilities": { "charge": true, "transfer": false, "payout": false },
  "tax_ids": [],
  "metadata": {}
}

customer.updated uses the same shape — including when it fires because a customer's default payment method changed.

customer.deleted and all three customer.tax_id.* events send an empty data: {}. To see current tax IDs, fetch the customer by id — tax_ids is included there.