v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Create a billing meter event

Creates a billing meter event.

post/v1/billing/meter_events

Response

Successful response.

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

event_namestring required

The name of the meter event. Corresponds with the event_name field on a meter.

identifierstring required

A unique identifier for the event.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'billing.meter_event' required

String representing the object's type. Objects of the same type share the same value.

payloadobject required

The payload of the event. This contains the fields corresponding to a meter's customer_mapping.event_payload_key (default is stripe_customer_id) and value_settings.event_payload_key (default is value). Read more about the payload.

timestampinteger required

The timestamp passed in when creating the event. Measured in seconds since the Unix epoch.