Skip to main content
POST
/
webhook
Create Webhook
curl --request POST \
  --url https://api.usecobalt.com/v1/webhook \
  --header 'Content-Type: application/json' \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '{
  "webhook_url": "<string>"
}'
{
  "success": true,
  "webhook": {
    "webhook_id": "<string>",
    "webhook_url": "<string>",
    "webhook_secret_key": "<string>"
  }
}
Creates a new webhook endpoint. The response includes a signing secret that you should store securely - it will be used to verify that incoming webhooks are actually from Cobalt.

​
Example Request

curl -X POST https://api.usecobalt.com/v1/webhook \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-d '{
    "webhook_url": "https://api.example.com/webhook"
}'

​
Example Response

{
    "success": true,
    "webhook_id": "wh_123456789",
    "webhook_url": "https://api.example.com/webhook",
    "webhook_secret": "whsec_abcdefghijklmnopqrstuvwxyz"
}
Store the webhook secret securely - you’ll need it to verify webhook signatures.

Authorizations

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

Body

application/json
​
webhook_url
string
required

The URL where webhook events will be sent

Response

200 - application/json

Successful response

​
success
boolean
​
webhook
object