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": "john+doe@tamio.com",
"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": "jane+doe@plugnpaid.com",
"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": "jane+doe@plugnpaid.com",
"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": "mike@plugnpaid.com",
"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": "mike@plugnpaid.com",
"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": "john.doe@tamio.com",
"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"
}