BetaUse webhooks in agents

Use webhook actions in agents to send and receive data from external systems. You can configure webhook actions in the agent builder to make HTTP requests (e.g., GET or POST), to trigger external processes or retrieve data.

Webhook actions help connect agents to external tools without requiring custom integrations. For example, you can send deal data to an external system to trigger fulfillment, or retrieve customer information from another platform and use it in your agent’s output.

Please note: you can manage AI feature access in your AI settings and configure what data is shared. Review HubSpot's AI Trust FAQs and AI Model Cards for detailed information on AI security controls, data use, and compliance.

Before you get started

Before you begin using webhooks in agents, review the requirements and considerations.

• A Super Admin must toggle the following switches on in AI Settings:

  • Give users access to generative AI tools and features

  • CRM data

  • Customer conversion data

  • Files data

  • Give users access to Breeze Assistant

Add a webhook action to an agent

Add a webhook action in the agent builder to send data to, or retrieve data from, an external system. Use the Method dropdown menu to select how the agent should communicate with the webhook URL:

• GET: retrieve values from another system. Use GET requests when the agent needs to reference information from an external system later in the agent run, such as a subscription status, order status, or customer profile field.

• POST: send values to another system. Use POST requests when the agent needs to trigger or update something outside of HubSpot, such as creating a fulfillment request, sending a notification, or updating an external record.

To add a webhook action:

1. In your HubSpot account, click More, then navigate to Agents > Agent Hub. If More doesn't appear in your account, navigate to Agents > Agent Hub directly.

2. Click the Agents tab.

3. Click Edit on an existing agent's card or create a new agent.

4. In the agent builder, click Add action in the Actions section.

5. In the right panel, enter Send a webhook in the Search field. Then click the Send a webhook action.

6. Click the Method dropdown menu and select the request type (e.g., POST or GET).

7. In the Webhook URL field, enter the URL where the request should be sent.

8. Click the Authentication type dropdown menu and select an authentication type.

9. Depending on the selected method (e.g., GET or POST), configure the values to include in the request.

   • For GET requests, in the Query parameters section, click Add static value to add the names and values to append to the webhook URL.

   • For POST requests, in the Request body section, click Add static value to add values to include in the webhook request body.

10. To test the webhook action, click Test. Review the response to confirm that the request is configured correctly. If the test fails, review the webhook URL, method, authentication type, query parameters, or request body, then test the action again.

11. When finished, click Save and add.
12. Continue to customize the agent and then publish.

Next steps

• Create and customize agents in the agent builder
• Run agents and review output in the agent inbox
• Review estimated credit costs when using agents