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

# List All Active Webhook Subscriptions for a Project

> Retrieve all webhook subscriptions in your Convo project, optionally filtered by Custom App name, with topics and delivery URLs.

Use this endpoint to retrieve all webhook subscriptions associated with your Convo project. Each webhook object includes the subscribed topics, delivery URL, and shared secret used for payload verification. Optionally filter by a specific Custom App name.

## Endpoint

```text theme={null}
GET https://connect.api-wa.co/project-apis/v1/project/{project_id}/webhook
```

## Authentication

```text theme={null}
X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD
```

## Path Parameters

**project\_id** `string` *required*

Your Convo project ID.

## Query Parameters

**app\_name** `string`

Filter webhooks by the name of the Custom App they belong to. If omitted, webhooks for all apps in the project may be returned depending on your setup.

## Request Example

```bash theme={null}
curl "https://connect.api-wa.co/project-apis/v1/project/YOUR_PROJECT_ID/webhook?app_name=MyApp" \
  -H "X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD"
```

## Response

Returns an array of webhook subscription objects.

**id** `string`

Unique identifier for the webhook subscription.

**app\_id** `string`

The ID of the Custom App this webhook is registered under.

**project\_id** `string`

The ID of the project this webhook belongs to.

**topics** `array`

List of event topics this webhook is subscribed to (e.g., `"contact.created"`, `"message.received"`).

**webhook\_url** `string`

The HTTPS URL where event payloads will be delivered.

**shared\_secret** `string`

A secret token you can use to verify that incoming webhook payloads originate from Convo.

**created\_at** `integer`

Unix timestamp (milliseconds) of when the webhook was created.

**updated\_at** `integer`

Unix timestamp (milliseconds) of the last update to this webhook.

## Example Response

```json theme={null}
[
  {
    "id": "627adef5f2d93aba6fa649d7",
    "app_id": "627ac3ce1b6404b276b1acae",
    "project_id": "6245d025fcb7966c46294618",
    "topics": ["contact.created"],
    "webhook_url": "https://your-server.com/webhook",
    "shared_secret": "8d008e6e505171aa...",
    "created_at": 1652219637153,
    "updated_at": 1652220659065
  }
]
```

## Error Responses

| Status Code | Description |
| - | - |
| `400` | Bad Request — The `app_name` provided does not exist, or a required parameter is missing. |
| `500` | Internal Server Error — An unexpected server-side error occurred. Retry the request or contact support. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.