Webhooks

Create a new webhook

Write requests are disabled on production docs to avoid account noise. Fill the request below, then copy the generated cURL, fetch, or JSON output.

Copy page

POST /api/v2/webhooks

Authorisation

Bearer token required. Include in the Authorization header.

Request body

topic string body

url string body

meta array body

Request body example

{
  "topic": "product:created",
  "url": "https://example.com/webhook",
  "meta": []
}

Create a new webhook

curl https://web.signcustomiser.com/api/v2/webhooks \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "topic": "product:created",
  "url": "https://example.com/webhook",
  "meta": []
}'

{
  "webhook": {
    "webhook_id": 1,
    "topic": "product:created",
    "url": "https://example.com/webhook",
    "status": "active",
    "secret": "abc123...",
    "meta": {},
    "created_at": "2024-01-01T00:00:00.000000Z",
    "updated_at": "2024-01-01T00:00:00.000000Z"
  }
}