User Guide

Everything you need to know from the basics through advanced features

  1. User Guide
  2.  » 
  3. Results Page
  4.  » Webhook Integrations

Webhook Integrations

Note: To utilize direct integrations, you or your web developer will need to understand how to listen for REST Webhooks. Alternatively, you can use Zapier to create integrations with your assessments without coding.

With an Advanced, Private Label, or Enterprise-level Assessment Generator account, you can choose to receive a notification via REST webhooks anytime someone takes your assessment.

To set up these notifications, edit your assessment and go to the Results tab. In the Results Setup section, enter the URL of your endpoint:

When your assessment is completed, the results will be sent to that URL as JSON-structured data:

"name":"Test User",
"email":"[email protected]",
"assessment_title":"Example Assessment",
"Type One":13,
"Type Two":10,
"Type Three":6,
"total_score":29, "high_scoring_types":"Type One", "pdf_report":null }

The content shown above is for a type-based assessment. For a simple assessment, a single score will be given instead of scores for each type. If you choose to generate a PDF in your results setup, the URL to the PDF for this result will be included in the pdf_report field.

Additionally, if you’ve provided an identifier for any of your questions, the text of the response to that questions will be included in the POST data, with the field name equal to the identifer you set. You can read more about how that works here.

Please review the rest of our User Guide to learn more about our software.