Event envelope

Every webhook arrives in the same envelope. The fields below are present on every event.

event envelope

1 {
2   "id": "evt_2nQv8c9aZmYHKr1...",
3   "type": "customer.health_score_dropped",
4   "created_at": "2026-05-26T18:42:00.000Z",
5   "org_id": "org_2bH...",
6   "livemode": true,
7   "api_version": "v1",
8   "data": {
9     "object": {
10       "id": "cus_2N...",
11       "display_id": 4218,
12       "name": "Acme Corp",
13       "health_score": 38,
14       "previous_health_score": 72
15     },
16     "previous_attributes": {
17       "health_score": 72
18     }
19   }
20 }

FIELDS

Field	Type	Notes
`id`	string	Stable event id. Use it for idempotent processing.
`type`	string	Dot-namespaced event type, e.g. `customer.created`.
`created_at`	ISO 8601	When the event fired, not when we delivered it.
`org_id`	string	The workspace that owns the resource.
`livemode`	boolean	`false` for events from `pivotal_test_` keys.
`api_version`	string	Always `v1` today. Reserved for future versioning.
`data.object`	object	The full resource at the time of the event.
`data.previous_attributes`	object \| null	Present on `*.updated` events with the prior field values.

1	{
2	"id": "evt_2nQv8c9aZmYHKr1...",
3	"type": "customer.health_score_dropped",
4	"created_at": "2026-05-26T18:42:00.000Z",
5	"org_id": "org_2bH...",
6	"livemode": true,
7	"api_version": "v1",
8	"data": {
9	"object": {
10	"id": "cus_2N...",
11	"display_id": 4218,
12	"name": "Acme Corp",
13	"health_score": 38,
14	"previous_health_score": 72
15	},
16	"previous_attributes": {
17	"health_score": 72
18	}
19	}
20	}