Skip to main content

Troubleshooting: Webhooks

Webhooks not received​

CheckSolution
URL correct?Verify the HTTPS URL in your webhook configuration
Event correct?Verify you selected the right event (Answer survey, Answer, Answer NPS)
Survey active?Webhooks only fire for active (non-preview) surveys
Endpoint accessible?Test your endpoint with a tool like webhook.site
HTTPS required?Told requires HTTPS endpoints — HTTP won't work

Incorrect or unexpected payload​

  • Refer to the webhook payload documentation
  • Different events have different payload structures:
    • surveyFormAnswer — data is an array of all answers
    • surveyAnswer — data is a single object
    • surveyNPSAnswer — data is a single object with NPS score

Webhook delays​

Webhooks are sent in real time but may experience delays if:

  • Your endpoint is slow to respond
  • There's network latency between Told's servers and your endpoint

Ensure your endpoint responds within a few seconds.

Testing webhooks​

  1. Use webhook.site to get a temporary test URL
  2. Configure it as your webhook URL in Told
  3. Complete a survey to trigger the webhook
  4. Inspect the received payload on webhook.site