Delete Webhook Subscription

Description

Delete a webhook subscription within your Bold Penguin tenant.

The endpoint returns an HTTP 204 status on success.

Endpoint

Staging

https://hookshot-uat.beta.boldpenguin.com/hooks/<hook-id>

Production

https://hookshot.boldpenguin.com/hooks/<hook-id>

Authentication

This endpoint requires an access_token from the authentication endpoint in the same environment with the appropriate permissions. Include it as a bearer token in an Authorization header for the request.

Authorization: Bearer <access_token>

Methods

DELETE

Request Syntax

DELETE /hooks/<hook-id>

URL Parameters

• hook-id
  • A unique ID for this subscription within your tenant.
  • Type: UUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  • Required: Yes

Response

The endpoint returns an HTTP 204 status on success.

Status Codes

• 204: Deleted
• 401 Unauthorized: The necessary authentication credentials are not present in the request or are incorrect.

Examples

Example Request

curl --request DELETE \
  --url https://hookshot-uat.beta.boldpenguin.com/hooks/6c229132-a29e-4b83-9f35-e532e7de28a4 \
  --header 'authorization: Bearer <access-token>' \

Example Response

204 No content