You can quickly troubleshoot issues with webhooks by following a few simple steps, and by making sure that your webhook subscription is configured correctly.
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
Ensure That Your Webhook Subscription is Set to Active
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:
Payload Size too Large for Server
If you have missing payloads (particularly around events like
application_form: finished_quoting )
and see 413 status codes in your logs, that indicates that your endpoint is rejecting our webhook
delivery because of the size of the payload.
Please note that these webhook payloads can be fairly large, so you may need to configure your endpoint to accept larger payloads. In almost every case, these payloads should not exceed a few hundred kilobytes.
For more information on configuring webhooks properly, take a look at our Create Webhooks API documentation.
Bold Penguin's webhook APIs use an access token that you obtain via the Authenticate API. If you have a valid
client_secret your may need to request a new token as these tokens expire every 12 hours.