Direct Integrations (via Webhook URL)

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",
"first_name":"Test",
"last_name":"User",
"email":"auser@example.com",
"group":null,
"assessment_title":"Example Assessment",
"date":"2019-03-29",
"time":"20:35:38",
"datetime":"2019-03-29T20:35:38+00:00",
"Type One":13,
"Type Two":10,
"Type Three":6,
"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.

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