spend.day_closed

Event type: spend.day_closed.

When it fires

An ad account's day ended, in its own timezone, with that day's spend.

Envelope

Every event shares these top-level fields. The event-specific fields are under data.

Field	Type	Required	Description
`id`	`string`	Yes	Unique event id. Deliveries are at-least-once, so dedupe on it.
`type`	`"spend.day_closed"`	Yes
`createdAt`	`string (date-time)`	Yes
`apiVersion`	`"v1"`	Yes
`organizationId`	`integer`	Yes
`brandId`	`integer \| null`	Yes
`accountId`	`string \| null`	Yes	The ad account the event concerns.
`provider`	`string \| null`	Yes	The ad platform the event happened on. One of `meta`, `whop`.

Data

Field	Type	Required	Description
`data.accountId`	`string`	Yes
`data.date`	`string (date)`	Yes	The closed day, in the ad account timezone.
`data.timezone`	`string`	Yes	IANA timezone of the ad account.
`data.spend`	`number \| null`	Yes	Total spend for the day. Null when it could not be read, never 0.
`data.currency`	`string \| null`	Yes

Example payload

{
  "id": "evt_2xKq7Vb9mN4pR8sT",
  "type": "spend.day_closed",
  "createdAt": "2026-09-19T14:30:00Z",
  "apiVersion": "v1",
  "organizationId": 1,
  "brandId": 1,
  "accountId": "string",
  "provider": "meta",
  "data": {
    "accountId": "string",
    "date": "2026-09-19",
    "timezone": "string",
    "spend": 12.5,
    "currency": "string"
  }
}

Delivery headers

Header	Required	Description
`webhook-id`	Yes	The delivery id; identical across retries of the same event. Dedupe on the envelope `id`.
`webhook-timestamp`	Yes	Unix seconds at signing time. Reject deliveries older than 5 minutes.
`webhook-signature`	Yes	Space-separated `v1,<base64 HMAC-SHA256>` signatures (Standard Webhooks). Two are sent while a rotated secret overlaps.

Acknowledge

Your response	Meaning
`2XX`	Return any 2xx status to acknowledge the delivery.

Signing, retries and endpoint setup are in the Webhooks guide.