Skip to main content

How to Connect Quiz Webhooks

Quiz webhooks send structured submission data from AtomicQuiz to a secure endpoint you control — CRM, middleware, automation tools, or custom scoring systems.

Configure them in Quiz settings → Webhooks, then publish so live visitors trigger the configuration.

Before You Start​

Make sure you have:

  • A quiz open in the AtomicQuiz editor (saved, with steps and Flow ready).
  • An HTTPS endpoint ready to receive JSON payloads (TLS required).
  • Webhook name labels your team will recognize in logs.
  • Access to Quiz webhook delivery or your receiver logs for verification.

Webhooks run parallel to Leads — submissions still store in Atomicat when Leads is enabled.

See Quiz webhooks (reference).

Step 1: Open Webhook Settings​

  1. Open the quiz in the editor.
  2. Click Settings in the header.
  3. Select Webhooks in the settings sidebar.

Step 2: Add a Webhook​

  1. Click Add webhook.
  2. Fill in:
FieldRequirement
Webhook nameShort internal label (required).
Webhook URLMust start with https:// (required).
DescriptionOptional team notes.
  1. Choose a send trigger (next step).
  2. Click Save in the webhooks panel.

The product validates name and URL and rejects non-HTTPS URLs.

Step 3: Choose a Send Trigger​

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 identifiers comma-separated as the product requests.

Notes:

  • Switching back to At each stage clears click-based identifier lists automatically.
  • Use click-based triggers when only specific buttons or options should fire the webhook.

Find identifiers in the quiz editor labels shown for clickable items configured for actions.

Step 4: Review the Sample Payload​

The settings screen includes a sample delivery so your technical team can prepare the receiver:

  • Event type and quiz metadata
  • Answers and completion status
  • Timing and basic visitor context

Answer field names depend on how you named questions and options in Builder.

Share the sample with whoever implements the endpoint before you go live.

Step 5: Save and Publish​

  1. Save webhooks in settings.
  2. The product reminds you to publish the quiz — webhook changes apply to live traffic only after publish.
  3. Click Publish and confirm site/domain/slug. See How to publish a quiz.

Draft webhook saves do not affect visitors on the already-published URL until you republish.

Step 6: Test on the Published URL​

  1. Open the live HTTPS quiz link in incognito.
  2. Complete a path that should trigger the webhook.
  3. Confirm your endpoint received the payload.
  4. Open Quiz webhook delivery in Atomicat to inspect delivery status when available.

Test each trigger type you enabled (stage completion vs click-based).

Optional: API Keys​

If your destination validates trusted senders, configure keys via Webhook API keys and match validation on your server.

Troubleshooting​

ProblemWhat to try
URL rejectedUse HTTPS only; check for typos or spaces.
No delivery on live quizRepublish after webhook save; test published URL not Preview only.
Click trigger never firesVerify comma-separated IDs match editor identifiers.
Receiver returns 4xx/5xxCompare payload to sample; check auth and field validation.
Duplicate eventsStage trigger fires per stage — adjust trigger or dedupe server-side.

Outcome​

Your quiz sends submission data to your HTTPS endpoint on the triggers you configured — live after publish and testable through your receiver and Atomicat delivery logs.

FAQ​

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 an additional delivery channel.

Do I need to republish after editing webhooks?

Yes. Live visitors use the published configuration.

Where do click-based identifiers come from?

Use labels or identifiers shown in the quiz editor for the clickable items you configured.

Can I add multiple webhooks?

Yes. Add separate rows for each destination with its own name, URL, and trigger.