---
title: Webhook Integrations
description: "## What is a Webhook? > A webhook is used for event-driven integrations and is one of the many ways applications can communicate with each other. They allow you to send real-time data from one system to another when a…"
url: "https://agolix.com/user-guide/webhook-integrations/"
updated: "2026-01-16"
category: Deliver Results
---

# Webhook Integrations

## What is a Webhook?

> A webhook is used for event-driven integrations and is one of the many ways applications can communicate with each other. They allow you to send real-time data from one system to another when a given event occurs.
>
>  -- Referenced from [https://cyclr.com/blog/what-is-a-webhook](https://cyclr.com/blog/what-is-a-webhook)

**NOTE:** To utilize direct integrations, you or your web developer must understand how to listen for REST Webhooks. Alternatively, you can [use Zapier to create integrations with your assessments](https://agolix.com/user-guide/application-integrations/) without coding.

 

## Send Notifications via REST Webhooks

With **Advanced**, **Private Label**, and **Professional** plans, you can automatically send a notification to your website or a third party tool 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:

![Custom Webhook URL Example](https://agolix.com/wp-content/uploads/2022/12/Custom-Webhook-URL-Example-1024x204.png)

### Data Structure Formats

The results will be sent to that URL as JSON-structured data when your assessment is completed.

#### Simple Assessments

Here is the data structure for **Simple** assessments:

```
{  
"name":"Test Respondent",
"first_name":"Test",
"last_name":"Respondent",
"email":"arespondent@example.com",
"group":null,
"assessment_title":"Example Assessment",
"date":"2019-03-29",
"time":"20:35:38",
"datetime":"2019-03-29T20:35:38+00:00",
"Score":13,
"pdf_report":null,
"response_id": 3446642c5ec945cc5
}
```

#### Type and Multi-Type Assessments

Here is the data structure for **Type** and **Multi-type** assessments:

```
{  
"name":"Test Respondent",
"first_name":"Test",
"last_name":"Respondent",
"email":"arespondent@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,
"total_score":29,
"high_scoring_types":"Type One",
"pdf_report":null,
"response_id": 3446642c5ec945cc5
}
```

### Send PDF Report

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.

### Send Responses to Individual Questions

Additionally, suppose you’ve provided an identifier for any of your questions. In that case, the text of the response to that question will be included in the POST data, with the field name equal to the identifier you set. You can read more about how that works [here](https://agolix.com/user-guide/application-integrations/#h-send-responses-to-individual-questions).

Please review the rest of the **[Reference Guide](https://agolix.com/user-guide/)** to learn more about our software.

Thank you for choosing **Agolix**!