Create billing meter event stream authentication session v2

Billing
Meter Event Streams
Create billing meter event stream authentication session

Creates a meter event session to send usage on the high-throughput meter event stream. Authentication tokens are only valid for 15 minutes, so you will need to create a new meter event session when your token expires.

Learn more about calling API v2 endpoints.

Parameters

No parameters.

Returns

Response attributes

  • idstring

    The unique id of this auth session.

  • objectstring, value is "v2.billing.meter_event_session"

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

  • authentication_tokenstring

    The authentication token for this session. Use this token when calling the high-throughput meter event API.

  • createdtimestamp

    The creation time of this session.

  • expires_attimestamp

    The time at which this session will expire.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

POST /v2/billing/meter_event_session
curl -X POST https://api.stripe.com/v2/billing/meter_event_session \
-H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
-H "Stripe-Version: 2025-08-27.preview"
Response
{
"id": "<AUTH_SESSION_ID>",
"livemode": "false",
"object": "v2.billing.meter_event_session",
"authentication_token": "token_12345678",
"created": "2024-06-01T12:00:00.000Z",
"expires_at": "2024-06-01T12:15:00.000Z"
}