QQardora

Integrations

Return survey results to your system

Register a callback, correlate responses and recover failed deliveries.

Step by step

  1. 1

    In Integration Center, register a public HTTPS webhook destination and securely copy its signing secret.

  2. 2

    Create a survey through the API with webhook_id and external_reference. The calling key also needs surveys:responses:read to request answer delivery.

  3. 3

    Send the survey’s returned public_url from your system. Each completed response queues a survey.response.submitted event.

  4. 4

    On your server, verify Qardora-Signature: HMAC-SHA256 over timestamp, a dot and the exact raw request body. Validate timestamp freshness and compare signatures securely.

  5. 5

    Deduplicate using Qardora-Event-ID, store the result durably, then return a 2xx response. Use external_reference, survey ID and response ID to correlate answers.

  6. 6

    Review delivery status, HTTP status and attempt count in Integration Center. Correct the destination before manually retrying a terminal failure.