Customer Events

A comprehensive list of events that can activate webhooks for customer changes, including creation, updates, and deletions.

Events

Event	Description
`customer-created`	Triggers whenever a new customer is created.
`customer-updated`	Triggers whenever a customer is updated.
`customer-removed`	Triggers whenever a customer is deleted.

Webhook Payload Examples

customer-created

{
  "event_id": "whev_mv95dy1v5br54pr5p",
  "event_type": "customer-created",
  "api_version": 2,
  "object": "event",
  "data": {
    "customer": {
      "id": "6e6edb99-46d1-4b6a-b270-97eaa9c07624",
      "email": "[email protected]",
      "name": "John",
      "last_name": "Doe",
      "country": "de",
      "locale": "en",
      "created_at": 1664480250,
      "stripe_customer_id": null,
      "object": "customer",
      "teammate_id": null,
      "timezone_offset": "+00:00",
      "category": "customer",
      "priority": "normal",
      "source": "import",
      "affiliate_partner_id": null,
      "billing_addresses": [
        {
          "id": "a6f75f5a-af4f-43e8-bfc9-616c03763be4",
          "object": "address",
          "phone": null,
          "name": "Tamio GmbH",
          "representative": "Jane Doe",
          "email": "[email protected]",
          "address": "Awesome Street",
          "city": "Frankfurt",
          "postcode": "12345",
          "state": null,
          "country": "de",
          "locale": "en",
          "shipping_address": false,
          "ip": null,
          "is_company": true,
          "vat": "DE1231233",
          "verified_vat": false
        }
      ],
      "shipping_addresses": [
        {
          "id": "eda78fa6-65d0-4ddb-bac8-6296de104ce7",
          "phone": "+1234564899",
          "name": "Tamio GmbH",
          "object": "address",
          "email": "[email protected]",
          "address": "Awesome Street",
          "city": "Frankfurt",
          "postcode": "12345",
          "state": null,
          "country": "de",
          "locale": "en",
          "shipping_address": true
        }
      ]
    }
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}

customer-updated

{
  "event_id": "whev_kv28w431nh7rw9d2r",
  "event_type": "customer-updated",
  "api_version": 2,
  "object": "event",
  "data": {
    "customer": {
      "id": "ecd97edb-9799-452d-bc18-d7b70374d8b4",
      "email": "[email protected]",
      "name": "Mike",
      "last_name": "Elps",
      "country": "de",
      "locale": "en",
      "billing_addresses": [
        {
          "id": "36ce9d60-c96e-4ae8-8b28-a51922efd9a1",
          "phone": null,
          "object": "address",
          "name": "Mike",
          "representative": null,
          "email": "[email protected]",
          "address": "James Street 3",
          "city": "Frankfurt",
          "postcode": null,
          "state": null,
          "country": "de",
          "locale": "en",
          "shipping_address": false,
          "ip": null,
          "is_company": false
        }
      ],
      "shipping_addresses": [],
      "created_at": 1665516136,
      "stripe_customer_id": null,
      "object": "customer",
      "teammate_id": null,
      "timezone_offset": "+00:00",
      "category": "customer",
      "priority": "normal",
      "source": "import",
      "affiliate_partner_id": null,
      "lead_status": null,
      "phone": null
    },
    "changes": [
      "new_address"
    ]
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}

customer-removed

{
  "event_id": "whev_34megjomyuz24qz6x",
  "event_type": "customer-removed",
  "api_version": 2,
  "object": "event",
  "data": {
    "id": "dacbd82e-ef74-4f45-ba6d-73bdc052b698",
    "email": "[email protected]",
    "name": "John",
    "last_name": "Doe",
    "country": "de",
    "locale": "en",
    "billing_addresses": [],
    "shipping_addresses": [],
    "created_at": 1664582322,
    "stripe_customer_id": null,
    "object": "customer",
    "teammate_id": null,
    "timezone_offset": "+00:00",
    "category": "customer",
    "priority": "normal",
    "source": "import",
    "affiliate_partner_id": null,
    "lead_status": null
  },
  "endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}