Skip to content
Extrovert Extrovert Docs

Receive Stripe billing webhooks

POST
/v1/billing/stripe/webhook

Unauthenticated by bearer token. Stripe authenticates requests with the Stripe-Signature HMAC header; invalid signatures are rejected before event parsing or persistence.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Accepted

object
status
required
string
Allowed values: ok
inserted
required
boolean
event_id
required
string
event_type
required
string

400

Section titled “400 ”

Invalid request.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

503

Section titled “503 ”

A required integration or server-side capability is not configured.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope