Skip to main content

Quiz webhooks

Webhooks let your quiz send structured submission data to a secure destination you control. They are useful for CRMs, spreadsheets middleware, automation tools, or custom scoring workflows.

Configure them under Quiz settings → Webhooks in the quiz editor.

Add a webhook​

  1. Open Settings in the quiz header, then choose Webhooks in the sidebar.
  2. Click Add webhook.
  3. Fill in:
    • Webhook name — a short label your team will recognize.
    • Webhook URL — must start with https://.
    • Description — optional notes for your team.
  4. Choose a send trigger (see below).
  5. Click Save inside the webhooks panel when you are done.

The product validates that both name and URL are present and that the URL uses HTTPS before saving.

Send triggers​

TriggerWhen it fires
At each stageAfter the respondent completes a stage of the quiz (useful for progressive enrichment).
Click-based triggerWhen selected clickable quiz items fire the configured action. Enter the identifiers requested by the product, separated by commas.

If you switch back to At each stage, any click-based list attached to the old trigger is cleared automatically so the configuration stays consistent.

Example delivery​

The settings screen includes a sample delivery so your technical team can prepare the receiving tool.

The sample can include event type, quiz information, answers, completion status, timing, and basic visitor context.

Answer fields are flexible and depend on how your quiz questions and answers are named.

After saving​

When webhooks save successfully, the product reminds you to publish the quiz so live visitors pick up the latest configuration.

Frequently asked questions​

Can I use HTTP without TLS?

No. Only HTTPS URLs pass validation.

Do webhooks replace Leads?

No. Leads still stores submissions in Atomicat. Webhooks are a parallel delivery channel.

Where do I find identifiers for click-based triggers?

Use the labels or identifiers shown in the quiz editor. Paste them comma-separated for click-based triggers.