usage.recorded

{ "event": "usage.recorded", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "usageEventId": "evt_9f8e7d6c", "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "featureCode": "api_calls", "value": 25, "ts": "2026-06-18T09:12:00.000Z" } }

When this fires

Once per processed usage event, after the async processor persists it. This is the only high-volume webhook: it fires at your own ingest rate, so it is excluded from the family select-all in the dashboard and must be subscribed to explicitly.

Delivery is asynchronous — events are batched through the usage pipeline, so expect seconds of delay relative to the original POST /usage/events call. The idempotency key is the usage event ID, so retries never duplicate.

Use it to mirror usage into your own analytics store without polling.

Body

application/json

string

required

event

string

required

Allowed value: "usage.recorded"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

usage.recorded

When this fires

Body

Response

​When this fires

Body

Response

When this fires