Use webhooks in workflows to send or retrieve information between HubSpot and other external tools. There are a variety of uses for webhooks. Examples of popular use cases for them include:
The publication of HubSpot contact data in another system, such as a CRM, when that contact fills in a specific form on your site.
Sending business data to an external shipment processing system to create a purchase order.
Sending chat alerts from your external system to your company’s chat flow to notify employees that something important has happened.
Retrieving data from another system to update your HubSpot records.
You can send POST and GET requests using workflows. HubSpot regulates webhook traffic separately from other workflow processes. This is done to simplify workflow and webhook performance. When a webhook is slow or expired, the workflow action may take longer than expected to execute.
Setting up a webhook in your workflow
In your HubSpot account, navigate to Automation > Workflows.
Click on the name of the workflow.
Click on the + icon to add an action.
In the right panel, select Send a webhook.
Click on the Method drop-down menu and select POST or GET.
Enter the webhook URL. Webhook URLs are restricted to a secure protocol and must start with HTTPS. To request specific information, you can add query parameters such as ?queryparameter=abc to the webhook URL. If no query parameter has been added, a generic POST or GET request will be sent.
Configure your authentication type to authenticate webhook requests:
To use a request signature in the webhook header:
Click on the Authentication type drop-down menu. Select Include request signature in header.
You can also use an API key or a public application created via a developer account for authentication.
When using an API key for authentication, the name of the API key and the location of the API key used will depend on how the webhook has been configured. For security reasons, the API key will not be displayed in any test requests. To use an API key:
Click on the Authentication type drop-down menu. Select the API key.
Enter the name of the API key.
Click on the API key location drop-down menu. Then select Query parameters or Request header. Learn more about using API keys in HubSpot.
When making a request to one of our HubSpot APIs:
Click on the API key drop-down menu and select a secret. The value of the secret must be in the format Holder [YOUR_TOKEN].
Set the value of the API key name to Authorization.
Set the API key location value to Request header.
When setting up a POST request, you can choose to include all the properties in the CRM record or send only specific properties:
To include all properties, in the Customize request body section, select Include all properties.
To include only specific properties:
In the Customize request body section, select Choose specific properties.
Click on the Choose property drop-down menu. Then click on [objeto] in this workflow and select a property.
To change the name of a property in the webhook, edit the Property name text field. This will only update the property name in the POST request, it will not update the property name or the internal name in HubSpot.
To add another property, click on Add property.
To remove a property, click on the deletetrash can icon.
When setting up a GET request, you can use properties as query parameters:
In the Query parameters section, click on the Choose property drop-down menu. Then click on [objeto] in this workflow and select a property.
To change the name of a property in the query parameter, edit the property name text field. This will only update the property name in the GET request, it will not update the property name or the internal name in HubSpot.
To add another property, click on Add query parameter.
To remove a property, click on the deletetrash can icon.
