> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Webhooks

> Retrieve all webhook registrations for your business 🤝

Retrieve all webhook registrations currently configured for your business. Use the returned `id` values when updating or deleting a specific registration.

## Endpoint

```json theme={null}
GET https://api.connectly.ai/v1/businesses/{businessId}/webhooks
```

## Example request

```bash theme={null}
curl --request GET \
  --url https://api.connectly.ai/v1/businesses/{businessId}/webhooks \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Response

```json theme={null}
{
  "entity": {
    "businessId": "biz_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "webhooks": [
      {
        "id": "wh_01ARZ3NDEKTSV4RRFFQ69G5FAV",
        "topic": "messages",
        "address": "https://example.com/webhook/messages",
        "configuration": {
          "echo": false,
          "channelTypes": ["whatsapp"],
          "filters": []
        }
      },
      {
        "id": "wh_02BRY4OEFLTUW5SSGGH70H6GBW",
        "topic": "delivery_status",
        "address": "https://example.com/webhook/delivery",
        "configuration": {
          "echo": false,
          "channelTypes": ["whatsapp"],
          "filters": [
            { "field": "campaign_name", "expression": "summer-promo-*" }
          ]
        }
      }
    ]
  }
}
```

**Response fields:**

| Field                                             | Description                                                                                                                                  |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `entity.businessId`                               | The business ID these registrations belong to.                                                                                               |
| `entity.webhooks`                                 | Array of webhook registration objects. Empty array if none are configured.                                                                   |
| `webhooks[].id`                                   | Unique identifier for this registration. Use with [Update webhook](/webhooks/update-webhook) and [Delete webhook](/webhooks/delete-webhook). |
| `webhooks[].topic`                                | The subscribed topic: `messages` or `delivery_status`.                                                                                       |
| `webhooks[].address`                              | The endpoint URL receiving events for this topic.                                                                                            |
| `webhooks[].configuration.echo`                   | Whether outbound messages are echoed back to this webhook.                                                                                   |
| `webhooks[].configuration.channelTypes`           | Channel types this webhook filters on.                                                                                                       |
| `webhooks[].configuration.filters`                | Active filter rules — each has a `field` and `expression`.                                                                                   |
| `webhooks[].configuration.webengageConfiguration` | Present only for WebEngage-type webhooks. Contains `webengageToken` and `webengageWebhookUrl`.                                               |

## Error responses

| Status | Meaning                                    |
| ------ | ------------------------------------------ |
| `401`  | Missing or invalid `X-API-Key`.            |
| `404`  | The specified `businessId` does not exist. |
| `500`  | Internal server error.                     |