Skip to main content

Webhook Overview

Set up your webhook endpoint to receive live events from Credo or learn more about Webhooks.​
Webhook Security​

When you add a webhook address (Callback URL) to Credo and profile a unique token for authentication purposes. We will then sign each request we make to the address using the X - Credo-Signature so you can verify the webhook is actually being sent by Credo central.

The X - Credo-Signature is calculated as SHA512 (Token + Business code) where Business code is your Credo assigned ID and can be retrieved from the Settings module of your Credo dashboard.

Webhook Structure​

All webhook payloads follow the same basic structure

Enabling Webhook​

Here's how to set up a webhook on your Credo account:

  • Log in to your dashboard and click on Settings.

  • Navigate to the Webhooks section to add your webhook/Callback URL.

  • Specify a secret token that will be used to sign each request.

  • Check the boxes to select events to listen to and save your settings.

Quick Tip​

When testing, you can get an instant webhook URL by visiting webhook.site. This will allow you to inspect the received payload without having to write any code or set up a server.