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

# Permanently Delete a Registered Webhook Subscription

> DELETE /project/{project_id}/webhook/{webhook_id} — Remove a webhook subscription and stop receiving notifications at that endpoint.

Use this endpoint to permanently remove a webhook subscription from your Convo project. Once deleted, Convo will immediately stop delivering event notifications to the associated URL.

<Warning>
  Deleting a webhook immediately stops all event delivery to that endpoint. Ensure you have an alternative event handler in place before deleting, or that you no longer need to receive these notifications.
</Warning>

## Endpoint

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

## Authentication

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

## Path Parameters

<ParamField path="project_id" type="string" required>
  Your Convo project ID.
</ParamField>

<ParamField path="webhook_id" type="string" required>
  The unique ID of the webhook subscription you want to delete.
</ParamField>

## Request Example

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

## Response

A successful deletion returns the following response:

```json theme={null}
{
  "status": "success"
}
```

<ResponseField name="status" type="string">
  Returns `"success"` when the webhook has been successfully deleted.
</ResponseField>

## Error Responses

| Status Code | Description                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------- |
| `404`       | Not Found — No webhook with the given `webhook_id` exists in the specified project.                     |
| `500`       | Internal Server Error — An unexpected server-side error occurred. Retry the request or contact support. |