# HubSpot Facebook CAPI Integration: Complete Workflow Setup Guide

HubSpot's powerful marketing automation combined with Facebook's Conversion API creates an unbeatable combination for tracking and optimizing your marketing campaigns. This guide will walk you through setting up [UTMSimple's Facebook CAPI integration](https://utmsimple.com/facebook-capi) specifically for HubSpot workflows.

## Why HubSpot + Facebook CAPI?

HubSpot workflows allow you to trigger actions based on contact behavior, form submissions, deal stages, and more. By integrating these workflows with Facebook CAPI through UTMSimple, you can:

- **Track multi-touch journeys** from initial lead to customer conversion
- **Send server-side events** that bypass ad blockers and privacy restrictions  
- **Optimize Facebook campaigns** based on actual business outcomes
- **Maintain data accuracy** even when cookies are blocked

## Step 1: Get Your UTMSimple Webhook URL

First, you'll need to set up your Facebook CAPI integration in UTMSimple:

1. Subscribe to the [Facebook CAPI product](https://utmsimple.com/facebook-capi) on UTMSimple
2. In your UTMSimple dashboard, enter your:
   - **Facebook CAPI Access Token**
   - **Facebook Pixel ID** (Dataset ID)
   - Select **HubSpot** as your CRM type
3. Copy your unique webhook URL - this is what you'll use in HubSpot workflows

## Step 2: Configure HubSpot Workflows

### Creating a Basic Lead Tracking Workflow

1. **Navigate to Workflows** in your HubSpot account (Marketing > Automation > Workflows)
2. **Create a new workflow** and choose "Contact-based"
3. **Set your enrollment trigger** (e.g., "Form submission" or "Contact property change")

for more details you can check this guide: [UTMSimple facebook capi integration](https://docs.utmsimple.com/books/facebook-conversion-api-fbcapi/page/guide-to-utmsimples-facebook-capi-integration)

[![Make sure CRM type is Hubspot in UTMSimple](https://docs.utmsimple.com/uploads/images/gallery/2025-08/scaled-1680-/image-1756215498572.png)](https://docs.utmsimple.com/uploads/images/gallery/2025-08/image-1756215498572.png)

### Adding the Webhook Action

1. **Add an action** to your workflow
2. **Select "Send a webhook"** from the list of actions
3. **Configure the webhook** with these settings:
   - **Method**: POST
   - **URL**: Your UTMSimple webhook URL
   - **Request body**: JSON format (see example below)

[![Guide to set webhook url in Hubspot](https://docs.utmsimple.com/uploads/images/gallery/2025-08/scaled-1680-/image-1756216379078.png)](https://docs.utmsimple.com/uploads/images/gallery/2025-08/image-1756216379078.png)

### Sample Webhook Payload for HubSpot

Here's a recommended JSON structure for your HubSpot webhook:

```json
{
  "format": "custom",
  "event_type": "Lead",
  "email": "{{ contact.email }}",
  "phone": "{{ contact.phone }}",
  "first_name": "{{ contact.firstname }}",
  "last_name": "{{ contact.lastname }}",
  "utm_source": "{{ contact.hs_analytics_source }}",
  "utm_medium": "{{ contact.hs_analytics_medium }}",
  "utm_campaign": "{{ contact.hs_analytics_campaign }}",
  "utm_term": "{{ contact.hs_analytics_term }}",
  "utm_content": "{{ contact.hs_analytics_content }}",
  "value": 0,
  "currency": "USD"
}
```


## Step 3: Advanced Workflow Examples

### Lead Qualification Workflow
Track when leads become Marketing Qualified Leads (MQLs):

```json
{
  "format": "custom",
  "event_type": "CompleteRegistration",
  "email": "{{ contact.email }}",
  "phone": "{{ contact.phone }}",
  "utm_source": "{{ contact.hs_analytics_source }}",
  "utm_medium": "{{ contact.hs_analytics_medium }}",
  "utm_campaign": "{{ contact.hs_analytics_campaign }}",
  "value": 25,
  "currency": "USD"
}
```


**Trigger**: Contact property "Lifecycle Stage" changes to "Marketing Qualified Lead"

### Deal Closed Won Workflow
Track actual revenue when deals close:

```json
{
"format": "custom",
"event_type": "Purchase",
"email": "{{ contact.email }}",
"phone": "{{ contact.phone }}",
"utm_source": "{{ contact.hs_analytics_source }}",
"utm_medium": "{{ contact.hs_analytics_medium }}",
"utm_campaign": "{{ contact.hs_analytics_campaign }}",
"value": "{{ deal.amount }}",
"currency": "{{ deal.dealcurrencycode }}"
}
```


**Trigger**: Contact books a meeting through your booking link

## Step 4: Testing Your Integration

1. **Create a test contact** in HubSpot that meets your workflow criteria
2. **Monitor the workflow history** to ensure the webhook fires successfully
3. **Check Facebook Events Manager** to verify events are being received

## Pro Tips for HubSpot Integration

### Use Contact Properties Effectively
- Leverage HubSpot's built-in UTM tracking properties
- Set up custom properties for additional attribution data
- Use calculated properties for dynamic event values

### Optimize Your Event Strategy
- **Lead**: Form submissions, content downloads
- **CompleteRegistration**: MQL conversion, trial signups  
- **Purchase**: Closed won deals, subscription renewals
- **Schedule**: Demo bookings, consultation requests

### Handle Multiple Touchpoints
Create different workflows for different customer journey stages to build a complete attribution picture in Facebook.

### Troubleshooting Common Issues

**Webhook not firing**: Check that your enrollment criteria are correctly set and the contact meets all conditions.

**Events not appearing in Facebook**: Verify your Facebook CAPI token and Pixel ID are correctly entered in [UTMSimple](https://utmsimple.com).

**Missing UTM data**: Ensure UTM parameters are being captured on your forms and landing pages.

### Next Steps

Once your HubSpot workflows are sending events to Facebook CAPI, you can:
- Create custom audiences based on these server-side events
- Optimize your Facebook campaigns for your most valuable actions
- Build lookalike audiences from your highest-value customers
- Set up automated bidding based on actual business outcomes

For additional support or advanced configurations, visit [docs.utmsimple.com](https://docs.utmsimple.com) or reach out to our team at [support@utmsimple.com](mailto:support@utmsimple.com).