Subscribing to channel created webhooks

When you make a request to install a new WhatsApp connector, this is an asynchronous process so you can subscribe the channel created webhook as follows

Set up a webhook subscription

post

Path parameters

organization_idstringRequired

The ID of the organization

workspace_idstringRequired

The ID of the workspace

Body

application/json

servicestringOptional

eventstringOptional

templatestringOptional

urlstringOptional

signingKeystringOptional

Responses

200

Successful response

No content

400

Bad request

post

/organizations/{organization_id}/workspaces/{workspace_id}/webhook-subscription

HTTPcURLJavaScriptPython

POST /organizations/{organization_id}/workspaces/{workspace_id}/webhook-subscription HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "service": "text",
  "event": "text",
  "eventFilters": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "template": "text",
  "url": "text",
  "signingKey": "text"
}

No content

Example

Replace {{webhook_url}} with an endpoint you will recieve webhooks and {{signing_key}} is a secret you can use to verify the webhook

curl --location 'https://api.bird.com/workspaces/<your-workspace-id>/numbers' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: AccessKey <your-access-key>' \
--data '{
  "service": "channels",
  "event": "channel.created",
  "url": "{{webhook_url}}",
  "signingKey": "{{signing_key}}",
  "eventFilters": []
}'

Example webhook