Ingest a usage event

Records a single usage event for billing and tracking. Events feed into invoice calculations for usage-based and hybrid plans.

Idempotency: Every event requires an eventIdempotencyKey. If a duplicate key is detected, the endpoint returns 409 Conflict — making it safe to retry on failure.

Customer identification: Use either customerReferenceId (your external ID) or customerId (Tanso UUID), not both.

Cost tracking: Optionally include costAmount to track provider costs (COGS) alongside usage. If omitted and a cost model is configured on the feature, Tanso calculates it automatically from usageUnits.

Language
Credentials
Response
Click Try It! to start a request and see the response here!