Skip to main content

Troubleshooting Webhooks

Introduction

You can quickly troubleshoot issues with webhooks by following a few simple steps, and by making sure that your webhook subscription is configured correctly.

General Troubleshooting

We recommend checking the configuration of your webhook subscription when you are experiencing issues. Common issues usually stem from misconfigured subscriptions, or no subscription at all.

To start, we recommend using our List Webhooks API to obtain a JSON payload that lists all of the webhook subscriptions on your Tenant, along with the associated configuration.

Not Receiving Webhook Events

This typically occurs when a webhook subscription is created that is not configured correctly.

If you are not receiving webhook events, check that your webhook subscription is set to active, and that you are subscribed to * events. An HTTPS URL must also be provided to receive webhook events.

An example basic configuration is shown here:

{
"active": true,
"events": ["*"],
"url": "https://my_demo_url.com"
}

For more information on configuring webhooks properly, take a look at our Create Webhooks API documentation.

Missing Event(s)

You can use the List Webhook Events API or the Redeliver Webhook Events API to programmatically monitor events and event deliveries for any issues.

Authentication

Bold Penguin's webhook APIs use an access token that you obtain via the Authenticate API. If you have a valid client_id and client_secret your may need to request a new token as these tokens expire every 12 hours.