# Set up a webhook

## Prerequisites

1. Complete the [getting started](../getting-started/index.md) tutorial to learn about how to set up a basic action.
2. Set up a [webhook](../../data-connection/webhooks-setup/index.md) to create a connection to an external system. You may need to work with a system administrator who has permissions to connect to source systems before creating a webhook.

## Steps

In the below example, suppose that we have a webhook called **Modify ticket priority** which accepts a `priority` string value and sends it to an external system.

Navigate to your action, select the **Logic** tab, select **Add new rule**, then select **Webhook**.

<img src="../../../assets/632f3b571a9476572d3648a9f966e443bce41c35810e6335a1137d55e9abd7fc.webp" alt="Add new webhook" width="600" />

By default, the newly added webhook is configured as a **side effect**; this makes the webhook run *after* objects are edited in Foundry. Alternatively, select **Writeback** to have the webhook run *before* object edits.

<img src="../../../assets/645c183a91963ff5a572eaf0468a2b0879c41f21237d19a2eb1da3a38802a24d.webp" alt="Select writeback or side effect" width="400" />

In the menu below, select the webhook you want to execute. In this example, we select the **Modify ticket priority** webhook. If you wish, you can select a different version of the webhook.

<img src="../../../assets/3dde35b0f585f268c5013cdc8951c505b0da8c423a26b41dfc2511b2847fc31d.webp" alt="Select webhook to execute" width="400" />

Next, configure webhook input parameters based on action parameters. By default, a new action parameter is generated for each webhook input unless an existing action parameter with the same name already exists, in which case the existing parameter is automatically configured. In this example, we map the webhook input called `priority` to an existing action parameter called `Ticket Priority`.

<img src="../../../assets/1644229b94edea62c38799af4a66d48ffd15f258da70cbb5d479e543f2d31164.webp" alt="Mapping webhook input to an existing action parameter" width="400" />

Select **Add webhook** to complete adding the webhook rule to your action. After the webhook is added, the Rules section shows that the writeback will occur before objects are modified.

<img src="../../../assets/bd77c3c95f4900ac1f404e3bc70c2fdf26f2cb9e378ed01c6992fdc63922f901.webp" alt="Add new webhook (completed)" width="600" />

You may want to remove any autogenerated parameters created when you added the webhook which are now unused.

<img src="../../../assets/bbba92708c7173241c39f80e253024bca3eba931c7505016cb7434be69169c4c.webp" alt="Remove autogenerated parameters" width="600" />

Select **Save** in the top-right to save your changes to the action. Now, when the action is applied, the request to the external system will be made before any changes are applied to objects in Foundry.

## Next steps

This tutorial demonstrated how to add a webhook to an action. To learn more, try these resources:

* View the [webhooks](../webhooks/index.md) section to learn about all the options available for webhooks in actions.
* Learn how to configure webhook input parameters using [functions](../webhooks/index.md#input-parameters).
* Learn more about the [webhooks concept](../../data-connection/webhooks-overview/index.md) in Data Connection.