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" } }

Cuándo se dispara

Una vez por cada evento de uso procesado, después de que el procesador asíncrono lo persiste. Este es el único webhook de alto volumen: se dispara a tu propia tasa de ingesta, por lo que se excluye del “seleccionar todo” de la familia en el dashboard y debe suscribirse de forma explícita.

La entrega es asíncrona — los eventos se procesan por lotes a través del pipeline de uso, así que espera demoras de segundos respecto a la llamada original a POST /usage/events. La clave de idempotencia es el ID del evento de uso, por lo que los reintentos nunca duplican.

Úsalo para reflejar el uso en tu propio almacén de analítica sin hacer polling.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "usage.recorded"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

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

Introducción

Eventos

usage.recorded

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara