Skip to main content
A webhook is an HTTP notification that Exoid sends to your system every time a relevant event happens, for example a new response coming in. You need it when you want data to land in your database, CRM or data warehouse the moment it’s collected, with no manual exports.
You enable webhooks from Settings (side toolbar) → Webhook.

The delivery flow

When an interview is completed, Exoid runs six steps in sequence.
1

Validation

Exoid checks that the response is correct and well-formed.
2

Formatting

The data is organized into a clean, consistent JSON payload.
3

Digital signature

The payload is signed with HMAC-SHA256 using the campaign secret.
4

Delivery

The data is sent with an HTTPS POST request to your endpoint.
5

Automatic retries

On a temporary error, Exoid repeats the request up to 7 times within one hour.
6

Logging

Every request is tracked and made available in the dashboard logs.
What happens after the POST leaves depends entirely on your server’s answer: a success closes the event, a temporary error puts the same request back in the queue, and a permanent error ends it there. Once the seventh attempt fails, the event is dropped.

Retry logic

If your endpoint doesn’t respond or returns a temporary code, Exoid makes up to 7 attempts with progressive delays.

When Exoid retries and when it doesn’t

There’s one rule: 429, 5xx and network errors trigger retries. 4xx request or authentication errors are permanent and the event is lost.
A permanent error (400, 401, 403, 404) triggers no retry at all: the event is lost. If your endpoint rejects a valid request — for example because signature verification is implemented incorrectly — that response will never be delivered to you again.
Failed requests remain viewable in the dashboard logs together with their status code.

Next steps

Configuration

Enable the webhook, set URL and secret, check the request logs.

Signature and security

Verify the HMAC-SHA256 signature before accepting a payload.

Payload reference

The full data model, response types and a complete example.