Connect your Webhooks (Beta)

You are here:
< All Topics

It is possible to have all the quiz data, including the recommended products, emails, and quiz responses sent to your own custom webhook.

Connect your webhook

To connect your custom webhooks to the quiz navigate to the Connect section of the quiz, scroll down to Webhooks and click “connect”.

A line will open that allows you to paste your webhook URL:

Test the connection

After the URL was added the quiz will save it automatically and you’ll be able to test your connection. To do that, click on the three dots (“…”) and select “Test webhook”.

    If you see an error it is recommended to:

  • check if your quiz has any responses in the Metrics -> Responses section. If there are none, you can do soem tests reposnes by clicking “test quiz”. After your quiz has some responses, you can test the webhook again.
  • check if the URL provided is correct and the webhook is active.

A success message depends on your webhooks settings and can look something like this:

Add HTTP headers (optional)

You can add multiple HTTP headers to each webhook that you create. To do that, test your webhook and click “+add new header”.

Data you’ll insert into the header fields will be sent together will all the quiz information via a POST request.

Activate the webhook

After you’ve successfully tested the webhook, you can activate it with the toggle button.

You can also easily turn it off later.

That’s it! From this moment, all the quiz data will be sent to the webhook via a POST request.

Add multiple webhooks

If you want to add another webhook to the quiz, click “+add new webhook”, paste a new URL and follow the same steps to test and activate it.

What data is sent to my webhook?

Webhooks receive all the data coming from the quiz. This includes the customer’s name, email, phone number, the recommended product details, quiz questions and answers, tags, the quiz permalink, the permalink to the quiz response, etc.

All this data is sent in via POST request. Below is a sample JSON payload sent on the POST request for a skincare quiz:

{
  "quiz_name": "Skincare Quiz (Basic Routine)",
  "quiz_id": "dbqHqN",
  "response_id": "NLTqvGqg",
  "first_name": "Paulina",
  "full_name": "Paulina",
  "email": "[email protected]",
  "emails": [
    "[email protected]"
  ],
  "products": [
    {
      "name": "The Ordinary \"Buffet\" + Copper Peptides 1%",
      "score": 2.102760090909091,
      "url": "https://skincarequiz.myshopify.com/products/the-ordinary-buffet-copper-peptides-1",
      "price": "27.0",
      "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/oily-serum.jpg?v=1568583098",
      "position": 0,
      "sku": "RHSK-016",
      "id": 4095078301780,
      "variant_id": 30099568885844
    },
    {
      "name": "Organix Facial Moisturizer",
      "score": 2.1020920909090908,
      "url": "https://skincarequiz.myshopify.com/products/organix-facial-moisturizer",
      "price": "36.0",
      "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/age-moisturizer.jpg?v=1568621334",
      "position": 1,
      "sku": "RHSK-012",
      "id": 4095721668692,
      "variant_id": 30104418451540
    },
    {
      "name": "All Natural Face Cleanser",
      "score": 2.101927090909091,
      "url": "https://skincarequiz.myshopify.com/products/all-natural-face-cleanser",
      "price": "32.0",
      "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/cleanser.jpg?v=1568621187",
      "position": 2,
      "sku": "RHSK-001",
      "id": 4095717834836,
      "variant_id": 30104403476564
    },
    {
      "name": "Fresh Rose Deep Hydration Toner",
      "score": 1.1010830909090907,
      "url": "https://skincarequiz.myshopify.com/products/fresh-rose-deep-hydration-toner",
      "price": "48.0",
      "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/fresh-rose-hydration.jpg?v=1568581379",
      "position": 3,
      "sku": "RHSK-006",
      "id": 4095053168724,
      "variant_id": 30099364773972
    }
  ],
  "blocks": [
    {
      "id": "Q2wTvD",
      "type": "HeadingBlock",
      "position": 0,
      "content": "{{slide:ZMiXjj}}, here's what your skin wants!"
    },
    {
      "id": "Qm0T1V",
      "type": "ContentBlock",
      "position": 1,
      "content": "Applying your skin care products in the proper order ensures that your skin receives the full benefits of each product.↵↵Enter this coupon code at checkout to get a 10% discount:↵**QUIZ123**↵↵"
    },
    {
      "id": "Qp7T9x",
      "type": "SlotsBlock",
      "position": 2,
      "slots": [
        {
          "id": "NXGuwK",
          "title": "Step 1: Cleanser",
          "position": 0,
          "products": [
            {
              "name": "All Natural Face Cleanser",
              "id": 4095717834836,
              "url": "https://skincarequiz.myshopify.com/products/all-natural-face-cleanser",
              "price": "32.0",
              "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/cleanser.jpg?v=1568621187",
              "sku": "RHSK-001",
              "variant_id": 30104403476564,
              "position": 0,
              "score": 2.101927090909091
            }
          ]
        },
        {
          "id": "RV6u0R",
          "title": "Step 2: Toner",
          "position": 1,
          "products": [
            {
              "name": "Fresh Rose Deep Hydration Toner",
              "id": 4095053168724,
              "url": "https://skincarequiz.myshopify.com/products/fresh-rose-deep-hydration-toner",
              "price": "48.0",
              "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/fresh-rose-hydration.jpg?v=1568581379",
              "sku": "RHSK-006",
              "variant_id": 30099364773972,
              "position": 0,
              "score": 1.1010830909090907
            }
          ]
        },
        {
          "id": "K6MuvR",
          "title": "Step 3: Serum",
          "position": 2,
          "products": [
            {
              "name": "The Ordinary \"Buffet\" + Copper Peptides 1%",
              "id": 4095078301780,
              "url": "https://skincarequiz.myshopify.com/products/the-ordinary-buffet-copper-peptides-1",
              "price": "27.0",
              "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/oily-serum.jpg?v=1568583098",
              "sku": "RHSK-016",
              "variant_id": 30099568885844,
              "position": 0,
              "score": 2.102760090909091
            }
          ]
        },
        {
          "id": "9OJulN",
          "title": "Step 4: Moisturizer",
          "position": 3,
          "products": [
            {
              "name": "Organix Facial Moisturizer",
              "id": 4095721668692,
              "url": "https://skincarequiz.myshopify.com/products/organix-facial-moisturizer",
              "price": "36.0",
              "image_url": "https://cdn.shopify.com/s/files/1/0273/8113/7492/products/age-moisturizer.jpg?v=1568621334",
              "sku": "RHSK-012",
              "variant_id": 30104418451540,
              "position": 0,
              "score": 2.1020920909090908
            }
          ]
        }
      ]
    }
  ],
  "answers": [
    {
      "question_title": "Leave us your email to receive an exclusive 10% discount on your next purchase:",
      "question_id": "KGQi5e",
      "values": [
        "[email protected]"
      ]
    },
    {
      "question_title": "Is your skin sensitive to any of the following ingredients?",
      "question_id": "yYqiz5",
      "choice_label": "Witch Hazel"
    },
    {
      "question_title": "Which of the following best describes the climate in which you live?",
      "question_id": "pa2i8L",
      "choice_label": "Desert or High Altitude"
    },
    {
      "question_title": "What is your main skin concern?",
      "question_id": "ydDimb",
      "choice_label": "Fine lines and wrinkles"
    },
    {
      "question_title": "How does your skin feel on an average day?",
      "question_id": "K72iWW",
      "choice_label": "Dry and tight all over"
    },
    {
      "question_title": "Pleased to meet you {{slide:ZMiXjj}}, what is your age?",
      "question_id": "p5Vi02",
      "choice_label": "40's"
    },
    {
      "question_title": "Before we get started... what's your name?",
      "question_id": "ZMiXjj",
      "values": [
        "Paulina"
      ]
    }
  ],
  "tags": [
    "sensitive_witch_hazel",
    "desert_area",
    "fine_lines",
    "dry_skin",
    "40s"
  ],
  "permalink": "https://skincarequiz.myshopify.com/#results-dbqHqN-NLTqvGqg",
  "permalink_hash": "#results-dbqHqN-NLTqvGqg",
  "created_at": "2022-07-15T13:18:30Z"
}
Table of Contents

Install the app and get started today

Add a Product Recommendation Quiz to your store and start offering a personalized shopping experience