---
title: Creating a Webhook
slug: neurons-for-itsm/admin-user-help/enu/latest/creating-a-webhook
createdAt: 2026-07-14T19:16:49.844Z
---
:::hint{type="info"}
**Important:** **Limited Support for Actions** At present webhooks only supports the **Insert Object** Action, either as a simple Action or through a composite Action. Support for more Actions will be added in future releases. See [Workaround: Updating an Incident using Webhooks](docId\:eOHJLf2OGG8oa_Df0Yz2Z) for an interim workaround for updating records.
:::
### To Create a Webhook:
1. In the **Settings **menu, click **Webhooks Manager** in the **Build **section.
:::Paragraph{indent="1"}
The **Webhooks Manager** opens.
:::
::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/0YWP5EdRGlpA7Lh8oi5l0_creatingwebhook.png" position="flex-start" size="40" initialPath="images/creating_webhook.png" githubPath="Content/Configure/Webhooks/images/creating_webhook.png" showCaption="false" indent="1"}
2. Click **Add a New Webhook**.
3. Enter information into the fields:
::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/I5wgN2IEMWlwygnw_VL4z_addwebhook1blanks.png" position="flex-start" size="40" initialPath="images/add_webhook1_blanks.png" githubPath="Content/Configure/Webhooks/images/add_webhook1_blanks.png" showCaption="false" indent="1"}
| Field | Description | Maximum Characters |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| Name | Enter a unique descriptive name for your webhook. For example, IncidentSendEmail. | 100 |
| Description | Describe what your webhook does. For example, sends an email to the general company technical support email address when a new incident is created. | 256 |
| Endpoint Extension | The extension that is appended to the end of your URL used to execute this specific webhook. For example, IncidentSendEmail.
**Note:** The endpoint extension is case-sensitive. | Alphanumeric only |
| Full Endpoint | This full endpoint automatically updates to add your endpoint extension onto the end.
If you click **Copy**, the full endpoint is copied into your clipboard so that you can paste it into a tool such as Postman so you can to test your request. | 2000 characters including the endpoint extension |
| Select Business Object | Select one of the business objects in your ITSM installation. They are shown in the format:
**BusinessObjectDisplayName (BusinessObject Name)**
**Tip:** You can also begin typing the name of your business object into this field and matches appear. | Not applicable.
|
| Select Action | When you select a business object, the list automatically displays associated Actions. Select the Action with the** Update Variables and Stored Actions** block you created for this webhook. They are shown in the format:
**ActionName (ActionType)**
**Tip:** Although using an Action with the **Update Variables and Stored Actions** block is probably what you'll want to do most of the time, you could also select other actions you've created, for example, a simple **Insert a record** action that doesn't read data from the webhook. | Not applicable. |
4. Click **Save**.
:::Paragraph{indent="1"}
A confirmation message appears saying **Webhook successfully created** if the save was successful. Your webhook appears in the list and is enabled by default.
:::
5. When the chosen trigger occurs, for example, pipeline failing in Azure DevOps, or record created in CSM, the webhook runs in the background and carries out its task.