Webhook Payload

When a user submits a funnel, Quizify sends a POST request to your subscribed webhook URL with structured submission data. This payload includes funnel details, user responses, contact fields, result method, and timing info.

Below is a real-world example of the webhook data you will receive.

Example Payload

jsonCopyEdit{
  "event": "new_funnel_submission",
  "data": {
    "id": 1752231840,
    "funnel_title": "Midnight Elegance",
    "source": "Quizify",
    "responses": {
      "What Are Your Favorite Hobbies": "Reading, Traveling, Cooking",
      "What Is Your Favorite Food": "Ramen",
      "How Much Do You Enjoy Social Gatherings": "7",
      "How Many Books Do You Read In A Year": "6",
      "How Would You Rate The Quality Of Your Daily Routine": "1",
      "What Is Your Preferred Mode Of Transportation": "Walking"
    },
    "First Name": "Sophie",
    "Last Name": "Spence",
    "Email": "sophie@example.com",
    "Subscribed To Newsletter": "No",
    "result_method": "Basic",
    "submit_date": "2025-04-29T08:33:14+00:00",
    "time_to_complete": "02:30:46"
  }
}

Field Descriptions

  • event: The event type (new_funnel_submission)

  • data.id: Unique ID of the submission

  • data.funnel_title: Title of the funnel completed by the user

  • data.source: Source of submission (e.g. Quizify)

  • data.responses: Object containing each quiz question as a key and the user’s answer as the value

  • First Name, Last Name, Email: Contact fields collected during the funnel

  • Subscribed To Newsletter: User’s response to newsletter opt-in, if present

  • result_method: Type of result logic used in the funnel (e.g. Basic, Scoring, etc.)

  • submit_date: Timestamp when the submission was completed (ISO 8601 format)

  • time_to_complete: Time taken to complete the funnel (in HH:MM:SS format)

Best Practices

  • Use the id and submit_date to ensure each record is processed once

  • Store and log Email, result_method, and responses for further processing

  • Handle all webhook data securely on your server and avoid exposing it in client-side code

  • Response must be returned within 5 seconds to prevent retry attempts

Tip: All submissions are also saved inside your Quizify dashboard. Even if your webhook fails temporarily, you won’t lose any data.