Skip to main content
POST
Create or update a webhook

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as Bearer <api_key>.

Headers

Idempotency-Key
string

Unique key for idempotent requests (24-hour cache)

Body

application/json
id
string

Existing webhook ID to update

url
string<uri>

Webhook endpoint URL (required for new webhooks)

events
string[]

Event types to subscribe to

enabled
boolean
default:true
secret
string

Custom signing secret (auto-generated if not provided)

metadata
object

Response

Webhook updated

id
string
required
url
string<uri>
required

Webhook endpoint URL

events
string[]
required

Event types to subscribe to

enabled
boolean
required
secret
string

Webhook signing secret

createdAt
string<date-time> | null
updatedAt
string<date-time> | null