Create a webhook

Request

POST /v1/webhooks

Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.

Parameters

Example

curl -X POST https://api.pollosoft.example/v1/webhooks \
  -H "Authorization: Bearer $COOP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "example-url", "events": [], "secret": "example-secret"}'

Response

A successful call returns 201 Created with JSON like this:

{
  "id": "whk_42f1",
  "url": "https://example.com/hook",
  "active": true
}

Errors

• HEN-2001 (401): Not logged in
• HEN-2004 (403): Insufficient pecking order
• HEN-5001 (429): Too many pecks
• HEN-1002 (400): Missing required field