> For the complete documentation index, see [llms.txt](https://help.getmobly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getmobly.com/help-center/integrations/crm/hubspot/connecting-marketing-events.md).

# Connecting HubSpot Marketing Events to Mobly Events

If your team uses HubSpot Marketing Events, Mobly can automatically add captured leads as event participants — including their participation status.

## Before you start

You'll need:

* The [HubSpot integration connected](/help-center/integrations/crm/hubspot/setup-guide.md) in Mobly
* A HubSpot **Marketing Hub** subscription (Marketing Events is a Marketing Hub feature; Sales Hub alone doesn't include it)
* An existing HubSpot Marketing Event — or permission to create one (Mobly can create it for you during setup)

## Where this lives

Marketing Event sync is configured **per event**, from the **Sync Event** bar on the event detail page. The bar sits above the tabs — it isn't a tab itself.

{% hint style="info" %}
**Not the Labels tab.** Mobly Labels and HubSpot Marketing Events are different things. Labels group leads inside Mobly by qualifier value, event, activation, or scan count. Marketing Events are HubSpot objects your event leads sync into. This article covers Marketing Event sync; for Labels see [How to use Mobly Labels](/help-center/labels/how-to-use-mobly-labels.md).
{% endhint %}

## Two object types for HubSpot

{% embed url="<https://getmobly.wistia.com/s/eh1tfslek6w0wub>" %}

The Sync Event bar offers HubSpot two ways to receive your event's leads:

| Object              | What it does                                                                    | Status step?                                  |
| ------------------- | ------------------------------------------------------------------------------- | --------------------------------------------- |
| **Marketing Event** | Adds captured leads as Marketing Event participants with a participation status | Yes                                           |
| **Segment**         | Adds captured leads to a HubSpot list (segment)                                 | No — segments don't carry a per-member status |

Pick whichever matches how your team reports on event attribution. You can connect both.

## Connect a Marketing Event to a Mobly Event

1. In Mobly, open the event you want to sync (**My Events → \[event name]**).
2. On the event detail page, find the **Sync Event** bar above the tabs.
3. Click **Connect HubSpot Marketing Event** (or **Connect HubSpot Segment**).
4. Choose how you want to link it:
   * **Find existing** — search your HubSpot Marketing Events by name. Results show date range, location, and current member count. If yours doesn't come up, click **Can't find your Marketing Event?** and enter the ID directly.
   * **Create new** — Mobly creates the Marketing Event in HubSpot and maps it automatically. Fields: name (required), start and end dates (pre-filled from your Mobly event), and an optional description.
5. **Preview** — confirm the name, date, location, member count, and HubSpot ID. Click **Continue**.
6. **Map Status** — pick the participation status captured leads should get (e.g. **Registered**, **Attended**). See [Choosing the participation status](#choosing-the-participation-status) below.
7. Click **Confirm and Sync**.

Once connected, the Sync Event bar shows a pill with the Marketing Event name, a **Marketing Event** chip, and the mapped status. Leads captured at this Mobly event sync to HubSpot as participants with that status.

{% hint style="info" %}
**Segments skip the status step.** If you connect a HubSpot **Segment** instead of a Marketing Event, the wizard is two steps — Select, then Confirm. There's no status to map because HubSpot list membership doesn't carry one.
{% endhint %}

## Choosing the participation status

What you see on the **Map Status** step depends on whether your org has registration mappings configured.

**If you use Registration mappings** — you'll get a row per Mobly registration state (**Registered**, **Checked-in**, **Live Capture**), pre-filled from your org-wide defaults. Edit any row to override just this event. See [Registration mappings](/help-center/integrations/crm/hubspot/setup-guide.md#registration-mappings) for how the defaults are set.

**If you don't** — pick a single HubSpot participation status that every lead captured at this event receives.

## Editing or disconnecting

Click the Marketing Event pill in the Sync Event bar to reopen the wizard in edit mode. From there you can change the mapped status, or click **Delete** to disconnect.

Disconnecting stops new captures from being added. Existing HubSpot participants stay in the Marketing Event — Mobly doesn't remove them.

## Syncing activations too

Activations have their own **Sync Activation** bar with the same flow, so a breakout or dinner can map to its own Marketing Event separately from the parent event.

If you sync an activation whose parent event isn't synced yet, Mobly warns you — event-level attribution will be missing until the parent is connected.

## Troubleshooting

If captured leads aren't appearing as participants in the HubSpot Marketing Event, the lead probably failed an upstream sync. Check **Integrations → HubSpot → Reconciliation** — see [Fixing HubSpot sync errors](/help-center/integrations/crm/hubspot/troubleshooting.md) for category-specific fixes.

## Related articles

* [HubSpot setup guide](/help-center/integrations/crm/hubspot/setup-guide.md)
* [CRM campaign sync](/help-center/integrations/crm/campaign-mapping.md) — the concept, and how it works across CRMs
* [Reconciliation](/help-center/integrations/crm/reconciliation.md)