--- title: Webhook-triggered AI agent slug: webhook-triggered-ai-agent image: https://archbee-image-uploads.s3.amazonaws.com/oAyFj2GHlBeBVWF5OAir2/q5mNWAm_KnXKLp8ucAfHR_triggers-1.png docTags: createdAt: 2026-03-19T11:05:07.360Z --- This webhook-triggered AI agent scenario watches for new data sent to a [webhook](docId:6NpTI6yVZkFtbSZMdl9EY) and the agent sends a reply back to the webhook. It is ideal for sending data from third-party services to Make. ![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/ZLeD3HAJdNsaS84txyqBK_webhook-triggered-ai-agent.png) ## Prerequisites - A [Postman account ](https://www.postman.com/) ## Step 1. Add a Custom webhook The **Webhooks **> **Custom webhook** module allows the agent to automatically receive new data from any third-party service. To add the **Custom Webhook **module: ::::WorkflowBlock :::WorkflowBlockItem In the Scenario Builder, click the giant plus. ::: :::WorkflowBlockItem In the app search, search for and click **Webhooks**. ::: :::WorkflowBlockItem Click the **Custom webhook** module. ::: :::WorkflowBlockItem In **Webhook**, click **Add **to create a new one. ::: :::WorkflowBlockItem In the **Create a webhook** dialog, in **Webhook name**, name your webhook to identify it later. ::: :::WorkflowBlockItem Optionally, in **API keys**, create an API key that consists of characters of your choice for additional security. ::: :::WorkflowBlockItem Copy the webhook URL to your clipboard. ::: :::: You've now added a **Webhooks **> **Custom webhook** module to your scenario. ## Step 2. Test the webhook in Postman To check that your webhook works, send a sample request to it from Postman. This action mimics a real request from a third-party service. To send the request in Postman: ::::WorkflowBlock :::WorkflowBlockItem Paste your webhook URL and select **POST**. ::: :::WorkflowBlockItem In **Body**, add the following configuration: ```json { "request" : "test", "conversationID" : "333333" } ``` ![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/R-3wljXY1ArUN3d2JfQNZ-20260211-100643.png) ::: :::WorkflowBlockItem In **Authorization**, if you have an API key: 1. In **Key**, enter `x-make-apikey`. 2. In **Value**, enter your APi key. ::: :::WorkflowBlockItem Click **Send **to send the request to the webhook. ::: :::WorkflowBlockItem Go back to your webhook scenario to check if you have a **Successfully determined **status below the webhook URL. This means that the webhook works. ::: :::WorkflowBlockItem Click **Save**. ::: :::: You've now tested your webhook URL in Postman. ## Step 3. Add a Run an agent module To add a **Make AI Agent (New)** > **Run an agent** module: :::::WorkflowBlock :::WorkflowBlockItem In the Scenario Builder, click the plus icon next to the **Webhooks** > **Custom webhook** module. ::: :::WorkflowBlockItem In the app search, search for and click **Make AI Agent (New)**. ::: :::WorkflowBlockItem Click the **Run an agent **module. ::: ::::WorkflowBlockItem In **Connection**, select an existing AI provider connection or click **Add **to create a new one. :::hint{type="info"} If you don't want to set up an account with an AI provider, select **Make's AI Provider**. ::: :::: :::WorkflowBlockItem In **Model**, select a model from your chosen AI provider. ::: :::WorkflowBlockItem In **Instructions**, describe who the agent is and what it does. For example, "You are a helpful agent who answers questions." ::: :::WorkflowBlockItem In **Input**, map the `request `value from the **Webhooks** > **Custom webhook** module. ::: ::::WorkflowBlockItem In **Conversation ID**, map the `conversationID` value from the **Webhooks** > **Custom webhook **module. The agent uses this ID to remember previous exchanges in the conversation and provide contextual responses when the user asks follow-up questions. The agent treats each new value as a new conversation. :::hint{type="info"} In Postman, you set a random Conversation ID value. ::: :::: :::WorkflowBlockItem Click **Save**. ::: :::WorkflowBlockItem Click **Save **on the Scenario toolbar. ::: ::::: You've now added a **Make AI Agent (New)** > **Run an agent **module to your scenario. ## Step 4. Add a Webhook response module The **Webhooks **> **Webhook response **module allows the agent to reply to the webhook request. To add the **Webhooks **> **Webhook response** module: ::::WorkflowBlock :::WorkflowBlockItem In the Scenario Builder, click the plus icon next to the **Make AI Agent (New)** > **Run an agent **module. ::: :::WorkflowBlockItem In the app search, click **Webhooks**. ::: :::WorkflowBlockItem Click **Webhook **response. ::: :::WorkflowBlockItem In **Body**, enter a simple JSON response: ```json { "response": "" } ``` ::: :::WorkflowBlockItem To replace the `` placeholder, map the Response value from the **Make AI Agent (New)** > **Run an agent **module. ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/1yAqhtukacNRS-9VOpZyB-20260211-105140.png" size="50" width="475" height="145" position="center" darkWidth="475" darkHeight="145" showCaption="false"} ::: :::WorkflowBlockItem Toggle **Advanced settings**. ::: :::WorkflowBlockItem In **Custom headers**, click **Add item** to define the type of data returned: 1. In **Key**, enter `content-type`. 2. In **Value**, enter application/json. ::: :::WorkflowBlockItem Click **Save**. ::: :::WorkflowBlockItem Click **Save **on the Scenario toolbar. ::: :::WorkflowBlockItem Toggle **Immediately as data arrives** to activate the scenario, so it's ready to receive incoming data as soon as it comes. ::: :::WorkflowBlockItem Click **Save**. ::: :::: You've now built a webhook-triggered scenario, so any third-party service can send data to the webhook and pass it into the agent.