---
title: "Creating Webhooks"
slug: "creating-webhooks"
updated: 2024-12-10T20:02:29Z
published: 2024-12-10T20:02:29Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Webhooks

## Overview

Webhooks give developers the option to implement custom logic that can communicate with other web applications in two ways:

- **Outbound**: An event happens externally, such as on **Facebook Messenger (e.g. message arrived) > **Webhook** > Run Decisions Flow.**
- **Inbound**: An event happens in **Decisions (e.g. assignment complete) > Webhook > External HTTP request.**

Webhooks are unlike API calls in the manner that API calls are request-based output mechanisms while Webhooks are event-based.

---

## Example

1. Navigate to **System > Integrations > Webhooks.**

There are a few webhooks that have been pre-loaded for users and trigger automatically when the proper event happens.

  - Assignment Created
  - Assignment Complete
2. Select **CREATE WEBHOOK**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-11_12h54_01.png)
3. Provide a Name, then click ADD NEW to add Data Definitions.
  1. Add an **Int32****Type**with the **Name**"Count", a **DateTime**Type called "Date", and a **String**Type called "Name". These Definitions will act as the Inputs for the Webhook step within the Flow Designer.
  2. Click **SAVE**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-11-05_15h00_10.png)
4. After creating the Webhook, right-click the Webhook and open the Action menu; select View Request Data.

The View Request data window shows the Data Definitions that were created while creating the Webhook in addition to the Event Name and the Date it was created on.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-11_12h57_12.png)

---

## Create Webhook Action

Webhook Actions are entities that define what the Webhook will do. The following tutorial demonstrates how to establish a Webhook Action.  
  
The URL for this example was generated using a [Webhook test site](https://webhook.site/).

1. From **System > Integrations > WebHook**, right-click the **WebHook**to open the Action menu, then select **Create WebHook Action.****![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-11-05_15h02_26.png)**
2. Define the Webhook Action by providing a **Name**and **URL**.
3. Select a **Request Type**via the dropdown menu. For this example, leave the Request Type set to Post.  
  
Note: Content-Type for POST is application/JSON format.
4. Provide any **Headers**or **Additional****Data**by clicking **ADD****NEW**under each section.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-11_13h03_23.png)
5. Click **SAVE**.
6. Back in the WebHook Folder, right-click the **WebHook Action**, then select **Test**.

If desired, users may also Edit or Delete the WebHook Action, or View its Request Data. 

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-11_13h05_06.png)
7. Navigate to the Webhook Test Site and view the updated resulting request details.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1644609564403.png)

---

## Run Webhook by Flow Step

Webhooks are registered as Flow steps under **Integration > Webhooks** to allow them to be triggered in a Flow. See that the Data Definitions defined earlier are available on this step.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1644609662583.png)

---

## Integration Activity

**Outbound****Webhook** activity can be viewed on the **Integration Activities** Report found under **System > Administration > System Tools > Flow Management.**

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1612457624325.png)

---

## Expose Flow as a Webhook

Flows can be exposed as **Webhooks**. Select **Configure** in the Flow Designer to see the information on how a Flow can be triggered.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1644609741110.png)

For this example, Postman was used to trigger the Webhook.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1644609882856.png)