Skip to main content

Send quiz data with webhooks

Segment shoppers and follow up on their product recommendations by sending quiz responses to your other tools as they're submitted.

Written by Simon Mainwaring

Overview

Turn every quiz response into a personalized follow-up. Quizzes webhooks send real-time quiz data, including answers and product recommendations, to external systems such as email platforms (ESPs), CRMs or analytics tools, even when they don't have a direct integration with Okendo.

Before you begin

🔔 Webhooks are available on the Advanced plan and above. View pricing.

New to webhooks? Read Getting started with webhooks and Okendo first.

Use cases for Quizzes webhooks

Here are a few examples of what merchants use webhooks for:

  • Send quiz data to your email marketing platform to segment customers based on:

    • Products recommended

    • Quiz answers (e.g. skin type, goal, style preferences)

  • Utilize product recommendations in your email marketing platform to follow up with shoppers and increase the opportunity for conversion.

  • Push responses to CRMs or customer profiles to support your retention or support teams.

  • Get notified when someone completes a quiz - great for internal alerting or downstream automation.

Events that can be subscribed to

You can configure webhooks to notify your system when a quiz response is:

  • Created - The most common use case whenever a quiz response is submitted.

  • Updated - When an existing response is updated with information - e.g. when an email is added to a response on the recommendation page to receive a coupon.

  • Deleted - When a response is deleted from the database - typically initiated by Okendo for specific cases.

Data included in each event

  • Quiz info

    • Quiz name

    • Quiz ID

    • Date of response

  • Customer info

    • Email

    • Customer ID

    • Order ID

    • Marketing opt-in status

  • Answered questions

  • Product recommendations

    • Recommended product and variant IDs

    • Quiz response ID - the ID appended to quiz's URL to view the recommendations on demand

    • Recommendation page title (conditional logic)

    • Runner up product and variant IDs (points logic)

    • Product points allocations (points logic)

    • Tags points allocations (points + product tags logic)

  • Reward or incentive offered (if applicable)

How to subscribe to Quizzes webhooks

Webhook setup requires some developer support. Your team will need to:

  1. Set up an endpoint to receive quiz data in your desired platform or use a middleware such as Zapier.

  2. Subscribe to webhook events through the Okendo API using the likes of Postman or through code.

  3. Test and verify that the events are being sent and received correctly.

Refer to our technical documentation for the full setup details:

Related Articles
Did this answer your question?