Stripe webhook handler (internal)

POST

/v1/billing/webhook

curl --request POST \
  --url https://api.hookbridge.io/v1/billing/webhook \
  --header 'Content-Type: application/json' \
  --data '{}'

• Production

Internal endpoint - not for direct API use. Handles Stripe webhook events to sync subscription status. Authentication is via Stripe signature verification.

Request Body^required

Media typeapplication/json

Stripe webhook event payload

object

Example^generated

{}

Responses

200

Webhook processed successfully

Media typeapplication/json

object

received

boolean

Example

{
  "received": true
}

400

Invalid webhook signature or payload

Media typeapplication/json

object

error

object

code

Machine-readable error code

string

message

Human-readable error message

string

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "endpoint must be a valid HTTPS URL"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}