Skip to main content
POST
Add a webhook URL
Registers a webhook URL for your account. A webhook is registered per account, so this one registration receives events for every connection and user under your account. The response includes the account-wide signing secret that you should store securely - it is used to verify that incoming webhooks are actually from Cobalt. Only client_id and client_secret headers are required. The request body accepts a single field, webhook_url; there is no per-connection webhook scoping.

Example Request

Example Response

Store the webhook_secret_key securely - you’ll need it to verify webhook signatures. It is a single account-wide key shared across all of your webhook deliveries.

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Body

application/json
webhook_url
string
required

HTTPS URL to receive webhook events.

Response

Webhook URL added

success
boolean
required
message
string
required
webhook_url
string
required
webhook_id
string
required
webhook_secret_key
string
required