---
updatedAt: 2025-06-03T00:41:02.000Z
agentTools:
  projectIndex: https://docs.ytel.com/llms.txt
---

# Webhooks

Webhooks allow you to send event-based data to your external application. There are two main components to setting up a webhook with Ytel: webhooks, and connections.

> 📘 Storing Authentication for Webhooks
>
> Although the webhook itself allows you to put in any header information you wish, it does not encrypt that information. Please use a Webhook Connection to store any sensitive authentication information.

## Webhooks

<Image title="This is some image..." alt="Alt text" align="center" border={true} src="https://files.readme.io/d239f60d3d637c42aebc23ee6f21b80f3d917be52b2fbaab86b87afc201ef818-Workflows_Screenshot_v1_2.png">
  Webhooks List (click to expand)
</Image>

View and manage your Ytel Webhooks using the Webhooks tab:

1. **Connection:** Create a new connection.
2. **Webhook:** Create a new webhook.
3. **Show Columns:** Show and hide columns displayed in your webhooks list.
4. **Export:** Export your webhooks list to CSV.
5. **Row Actions:** Clone or delete a webhook.

## Create Webhook

<Image title="This is some image..." alt="Alt text" align="center" border={true} src="https://files.readme.io/f7bc5453b246bb52a298df0e0ab0f8df81dcace9637c3781e9dcdbd145d35da7-Create_Webhook_Screenshot_v1_1.png">
  Create Webhook (click to expand)
</Image>

When creating a new webhook, you’ll find the following fields:

1. **Name:** Give your webhook a meaningful name for future reference.
2. **Connection:** Select an existing connection. You can also create a new connection by clicking on the Add new link.
3. **Method:** Choose the REST method for sending the webhook. In most cases, you’ll use POST.
4. **Request URL:** Endpoint for your external application that will receive the Ytel Webhook.
5. **Content Type:** Format for your request body. JSON, MULTIPART-FORM-DATA, and FORM-DATA are available options.
6. **Event Type:** Select the Ytel Event that should trigger the webhook callout to be sent.
7. **Add Header:** Used to add non-sensitive header information to the webhook callout.
8. **Request Body:** Payload to be included in the webhook callout. This should be formatted as the Content Type you selected.
9. **Response Processing:** Used to process callout responses from your external application. JSONPath is used to narrow down to a specific node within the response in order to save it to a Ytel variable. Both Success and Error response variables can be created.
10. **Failure Strategy:** Specifies whether or not the webhook should be retried in the event of an error response.

<br />

NOTE: Although you can place authentication information in the webhook header, it won’t be encrypted. Use Connections to store your authentication data securely.

## Connections

Connections store private webhook authentication information. Ytel securely stores authentication data at rest with encryption.

<Image align="center" className="border" width="100%" border={true} src="https://files.readme.io/d3401958789a57ca7e4d68eff0882fcd0486929d8572863f91e4e30df17ed576-Connections_Screenshot_v1.png" />

Use the connections tab to view and manage your webhook connections:

1. **Connection:** Create a new connection.
2. **Webhook:** Create a new webhook.
3. **Show Columns:** Show and hide columns displayed in your connections list.
4. **Export:** Export your list of connections to CSV.
5. **Row Actions:** Delete an existing connection.

<br />

## Create Connection

<Image align="center" className="border" border={true} src="https://files.readme.io/c9c663c8648254dab43082d36bb72745c6b918ec087514dfc953fa178328acf9-Create_Connection_Screenshot_v1.png" />

When creating a new connection, you will complete the following fields:

1. **Name:** Give your connection a descriptive name.
2. **Description:** Summarize your new connection's use.
3. **Add Authorization Header:** Add authorization headers using key-value pairs.
4. **Add Header:** Add non-authentication headers using key-value pairs.