Workflows

Use webhooks with HubSpot workflows

Last updated: March 11, 2019

Applies to:

Marketing Hub Enterprise
Sales Hub Enterprise
Service Hub Enterprise

Use webhooks in workflows to pass information from HubSpot to another web application.

Please note: Marketing Hub Professional accounts or Sales Hub Professional seats purchased before November 1, 2018 will have legacy access to the Trigger a webhook workflow action. 


Understand webhooks

Webhooks send data from one web application to another after an action is completed in the source application. You can use webhooks to send data, notifications, alerts, or any other real-time updates.

Examples of popular use cases for webhooks include:

  • Posting HubSpot contacts data to another system, such as a CRM, when that contact fills out a particular form on your site.

  • Sending deal data to an external shipment-handling system to create a purchase order.

  • Sending chat alerts from your external system to your company's chat stream that lets employees know something important has happened.

 

 Set up a webhook in your workflow

  • In your HubSpot account, navigate to Automation > Workflows.
  • Click the name of the workflow.
  • Click the + icon to add an action.
  • In the right panel, select Trigger a webhook.
  • Enter the webhook URL.

Please note: webhook URLs are restricted to a secure protocol and must begin with HTTPS.

  • Select the Use Request Signature checkbox to authenticate any requests to your webhook and enter your App ID. Learn how to verify request signatures.
  • Click Save.

Please note: the Trigger a webhook action only supports the POST method.

 

Test your webhook

After you create your workflow with a webhook action, you can run a quick test with a dummy webhook URL. In your browser, navigate to https://webhook.site and copy the unique URL that is automatically created. In the Webhook URL field in your webhook action, paste the URL.

The example below shows the Request Body of the webhook above, which reveals meta information about a specific contact, including contact information, form submissions, list memberships, etc. When the workflow action was triggered, HubSpot sent the contact's entire record formatted in JSON to the specified URL.

User-added image

The receiving system can then parse the JSON data, and use it for its own application.

Learn more about webhooks in the developers webhooks documentation. If you have questions about your specific implementation of webhooks with HubSpot, reach out on the HubSpot Developers Forums.

 

Verify request signatures in workflow webhooks

Where you've selected Request signature in the Authentication section for your Trigger a webhook action, HubSpot will populate the webhook with a X-HubSpot-Signature header with a SHA-256 hash of the concatenation of the app-secret for your application, the HTTP method, the URI, and the unparsed body. Learn more about this in the developers documentation.

To verify that the requests received at your URL are from HubSpot: