Skip to main content
POST
Rotate a webhook secret

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Headers

Idempotency-Key
string

A unique key per operation (a UUID works). Retrying with the same key returns the original response.

Path Parameters

endpointID
string<uuid>
required

Response

The new signing secret (shown only once).

The newly created endpoint, with the signing secret (secret), shown only here.

id
string<uuid>
url
string<uri>

URL that receives deliveries.

events
string[]

Subscribed events. Any emitted event can be subscribed to by name, including ones without a documented payload yet.

isActive
boolean

Whether the endpoint is receiving deliveries.

createdAt
string<date-time>
secret
string