Webhooks are a way that you can listen to real-time events from Acceptd. A webhook is a free, open standard that allows multiple applications to communicate. Acceptd supports webhooks for a number of different events.
In order to set up a webhook in Acceptd, you'll first need to create an endpoint in your receiving system. Once you have a URL ready to accept webhook events you may configure it using these steps, even if your organization is not currently accepting applications in Acceptd.
- Navigate to Organization and select Integrations from the dropdown menu
- Click the Create Webhook button to create a new webhook
- Complete the fields on the next page:
- Name - The name you'll use to identify the webhook in Acceptd
- Payload URL - The URL where webhook events should be delivered. For data security, the Payload URL must use HTTPS
- Events - The event(s) that should trigger a POST request to the Payload URL. Multiple events can be enabled for a single webhook, or separate webhooks can be configured for each event type.
- Enable this webhook? - Check this box to activate the webhook
When a webhook is configured correctly, Acceptd will send send a POST request to your webhook's URL and respond via JSON. You can use the Secret Token to verify the authenticity of webhook notifications sent from Acceptd using Hash-based Message Authentication Code (HMAC), SHA-256 Encryption.
Clicking on an existing webhook will display it's Recent Activity. If a webhook notification fails 5 consecutive times, the webhook will be automatically disabled and your organization's administrative contact will receive an email alert.