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 (verify bearer token from authentication)
  • 500: Internal server error

Examples

Example Request

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

Example Response

204 No content

← Create Webhook SubscriptionGet Attachments →