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

servicestringOptional

eventstringOptional

templatestringOptional

urlstringOptional

signingKeystringOptional

Responses

200

Successful response

400

Bad request

post

HTTPcURLJavaScriptPython

POST /organizations/{organization_id}/workspaces/{workspace_id}/webhook-subscription HTTP/1.1
Host: 
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

Below is a sample channels created event:

{
  "service": "channels",
  "event": "channel.created",
  "organizationiD": "{{orgId}}
  "workspaceId": "{{workspaceId}}"
  "payload": {
      "id": "{{channelid}}",        
      "platformId": "whatsapp"
      "connectorId": "{{connectorid}}"
      "identifier": {{whatsappphoneid}}
      "name": {{channelname}}
      "status": "active"
  }
}