Set 'When a webhook is received' workflow triggers

Set enrollment triggers to automatically enroll records in a workflow when a webhook is received from an external third-party. Learn more about setting up your workflow enrollment.

To trigger a workflow from a webhook:

1. In your HubSpot account, navigate to Automation > Workflows.
2. Click the name of an existing workflow or create a new workflow.
3. If you're creating a workflow from scratch:
   • In the left panel, click to expand the Custom events & external events section.
   • Click Received a webhook from an external app. 
4. If you're working on an existing workflow:
   • In the workflow editor, click the Trigger enrollment for [object] card.
   • If there are existing workflow triggers, in the left panel, click Change start trigger. This will erase any current enrollment triggers. 
   • In the dialog box, click Confirm.

1. • In the left panel, under Advanced options, click When a webhook is received.
2. To add a new webhook, click + Add a webhook. You can create up to 100 unique webhook events.
   
   

6. Add a Webhook event name. Then, click Next.
7. Copy the Webhook URL and paste it into the webhook settings page of the app you want to integrate with. From your app, use the webhook URL to send a test event.
   
    
   
    
8. In the Review your test event section, review the webhook event and make updates as necessary. Then, click Next.
9. Map the data for your webhooks properties:
   • Edit the HubSpot property label as necessary.
   • Click the Data type dropdown menu to select a data type for each property label.
     • You can use string, enum, number, and boolean values.
     • Datetime properties are not supported and should be mapped as string values instead. After, you can use a custom code action with strtotime to convert to a date time object, and then use unixtimestamp to get a timestamp. 
   • To remove a property label, click the Delete icon.
10. Click Next.
11. Match your enrollment property by selecting a property from your third-party webhook that's an exact match for one of your HubSpot custom properties. Then, click Next.
    
    • The workflow can only be triggered if the selected third-party webhook property has a non-empty value in the incoming webhook data.
    • The custom property must have Require unique values for property checkbox selected. Or, create a new property with a unique value required. 
12. Click Continue to trigger setup.
13. To use the webhook as an enrollment trigger, click the name of the webhook in the left panel. Then, click Save.