OCT-103 Gumlet outreach
DELETE/org/webhooks/{webhook_id}

Delete a webhook listener

Deletes a webhook listener so it no longer receives matching event notifications. Identify the listener with webhook_id; use the webhook listing operation to find its identifier if needed. Deleting a listener cannot be undone through this operation.

1 parameter
webhook_idstringrequired

The unique identifier of the webhook listener you want to delete.

5 status codes
204Returns an empty response after the webhook listener is deleted.
400Returned when the request is malformed.

One documented failure

  • webhook_id_not_valid

    The webhook is not valid.

errorobjectrequired
401Returned when the API key or bearer token is missing or invalid.

One documented failure

  • invalid_api_key

    API key supplied with request is invalid

errorobjectrequired
403Returned when the account is unpaid or the authenticated user lacks the required role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired
404Returned when the webhook listener is not found.

One documented failure

  • webhook_not_found

    Could not find any webhook with the specified webhook_id.

errorobjectrequired

Error handling

A 400 is returned for a bad request, a 401 when the API key or bearer token is missing or invalid, a 403 when the account is unpaid or lacks the required role permissions, and a 404 when the webhook is not found. The webhook_id path parameter must identify the webhook listener you want to delete.