Permanently Delete a Registered Webhook Subscription

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.

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.

Endpoint

DELETE https://connect.api-wa.co/project-apis/v1/project/{project_id}/webhook/{webhook_id}

Authentication

X-API-WA-Project-API-Pwd: YOUR_API_PASSWORD

Path Parameters

string

required

Your Convo project ID.

string

required

The unique ID of the webhook subscription you want to delete.

Request Example

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:

{
  "status": "success"
}

string

Returns "success" when the webhook has been successfully deleted.

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.

⌘I

Overview

Business & Project

Messages

Contacts

Templates

Campaigns

Webhooks

Catalogue

Media

Permanently Delete a Registered Webhook Subscription

Endpoint

Authentication

Path Parameters

Request Example

Response

Error Responses

​Endpoint

​Authentication

​Path Parameters

​Request Example

​Response

​Error Responses

Endpoint

Authentication

Path Parameters

Request Example

Response

Error Responses