Create a webhook endpoint

POST

/v1/webhooks

curl -X POST "https://us1.platform.bird.com/v1/webhooks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/bird",
    "events": [
      "email.delivered",
      "email.bounced"
    ],
    "description": "Production delivery + bounce notifications"
  }'

Registers a new webhook endpoint for the workspace. The signing secret is returned in the response body exactly once — store it immediately. It cannot be retrieved again; use rotate-secret to generate a new one.

Request Payload

url

string

आवश्यक

HTTPS URL to deliver events to.

events

array of string

आवश्यक

Concrete event types to subscribe to.

description

string

Human-readable label for this endpoint.

Response Payload

string

आवश्यक

url

string

आवश्यक

description

string

events

array of string

आवश्यक

Concrete event types this endpoint is subscribed to.

status

string

आवश्यक

created_at

string

आवश्यक

updated_at

string

आवश्यक

secret

string

आवश्यक

Signing secret (whsec_ prefix). Present in this response only — store it immediately, it cannot be retrieved again.

curl -X POST "https://us1.platform.bird.com/v1/webhooks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/bird",
    "events": [
      "email.delivered",
      "email.bounced"
    ],
    "description": "Production delivery + bounce notifications"
  }'