Skip to main content
This guide shows you how to list and delete webhook subscriptions. Use these operations to review your active subscriptions or remove subscriptions you no longer need.

​
Prerequisites

Before you start, make sure you have:
  • Session token: A valid session token. See the Authentication guide to learn how to obtain one.
  • API key: Your static API key provided by Quivo.
  • Subscription UUID: The UUID of the subscription you want to delete. You can obtain this by listing your subscriptions or from the response when you created the subscription.
All API examples in this guide use ${BASE_URL} as a placeholder. Replace it with the correct base URL configured for the correct environment. For more information see Environments page.

​
List active subscriptions

List subscriptions when you need to review all webhooks currently configured for your account or find a subscription UUID. Use the GET /subscriptions endpoint to retrieve all active subscriptions.
Use this request to list all active webhook subscriptions for your account.
curl -X GET "${BASE_URL}/subscriptions" \
  -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
  -H "Authorization: <YOUR_SESSION_TOKEN>"

​
Get a specific subscription

To retrieve details for a specific subscription, use the GET /subscriptions/{uuid} endpoint with the subscription UUID. Replace <YOUR_SUBSCRIPTION_UUID> with the UUID of the subscription you want to retrieve.
Use this request to retrieve details for a specific subscription by its UUID.
curl -X GET "${BASE_URL}/subscriptions/<YOUR_SUBSCRIPTION_UUID>" \
  -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
  -H "Authorization: <YOUR_SESSION_TOKEN>"

​
Delete a subscription

Delete a subscription when you no longer want to receive notifications for a specific event. Use the subscription UUID obtained when you created it or listed subscriptions. Delete it via the DELETE /subscriptions/{uuid} endpoint. Replace <YOUR_SUBSCRIPTION_UUID> with the UUID of the subscription you want to delete.
Use this request to delete a webhook subscription by its UUID.
curl -X DELETE "${BASE_URL}/subscriptions/<YOUR_SUBSCRIPTION_UUID>" \
  -H "X-Api-Key: <YOUR_STATIC_API_KEY>" \
  -H "Authorization: <YOUR_SESSION_TOKEN>"

​
Where to go next

Now that you can manage subscriptions, continue with these guides:

Create Subscriptions

Learn what subscriptions are and how to create them.

Webhook Responses

Configure and manage event subscriptions via the API.