> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundchecklive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot ↔ Flex pipeline

> Keep HubSpot deal stages, Flex quotes, and Soundcheck gigs in lockstep through a signed n8n sync.

> [!NOTE]
>
> The HubSpot ↔ Flex pipeline is part of **Sync Engine** on the **Enterprise** plan. Soundcheck sets it up with you for each organization through n8n. To get started, email [info@soundchecklive.io](mailto:info@soundchecklive.io).

![HubSpot details panel open over the Integrations page in the connected state, showing the last four characters of the saved key](https://mintcdn.com/soundchecklive/65-EmLPt4EBexIaJ/images/integrations/hubspot-light.png?fit=max\&auto=format\&n=65-EmLPt4EBexIaJ\&q=85\&s=35f0bed3649a7bc62daf8d78afa5bcfc)

The HubSpot ↔ Flex pipeline keeps three systems aligned: a **deal** in HubSpot, a **quote** in Flex, and a **gig** in Soundcheck. As a deal moves through your HubSpot pipeline, the matching Flex quote is created or updated, and the linked gig's status moves in Soundcheck.

Like [n8n CRM sync](https://docs.soundchecklive.io/integrations/n8n-crm-sync.md), the status sync runs through **n8n**, which owns the HubSpot and Flex calls for the pipeline. Soundcheck accepts each update only through a **signed** webhook for your organization, and records the quote, its links, and the gig status.

## Connect HubSpot and Flex

An owner or admin can save a HubSpot or Flex key in **Settings → Apps & data → Integrations**:

1. Click the **HubSpot** or **Flex Rental Solutions** card.
2. Enter your **API Key**. For Flex, also enter your account subdomain as **Account ID** (for example, `mapache` in `mapache.flexrentalsolutions.com`). Without it, AI assistants can't read your Flex data. HubSpot **Portal ID** is optional.
3. Click **Save Connection**.

Soundcheck encrypts the key and shows only its last 4 characters. The pipeline itself runs through n8n, but the saved keys are still used. Soundcheck uses them when an AI assistant (MCP) reads your HubSpot or Flex data, and the Flex key powers the Flex purchase-order pull.

![Sync section with the HubSpot ↔ Flex pipeline card, its last run and the Sync now button, above the Pipeline cross-links table](https://mintcdn.com/soundchecklive/65-EmLPt4EBexIaJ/images/integrations/pipeline-sync-light.png?fit=max\&auto=format\&n=65-EmLPt4EBexIaJ\&q=85\&s=c3d4d31c8cd466e9056f0b5ff91c29f9)

Once the pipeline is set up, the same page shows a **Sync** section with a **HubSpot ↔ Flex pipeline** card:

* The card shows the last run time, its status, and the last error, if there was one.
* Click **Sync now** to run the sync on demand. The button stays off until the pipeline is configured for your organization.
* The **Pipeline cross-links** table lists each matched HubSpot deal and Flex quote, with its status, amount, and show start. New rows appear after the sync finishes.

Owners, admins, and gig coordinators can run the sync.

## Status mapping

Soundcheck sets the gig's status from the HubSpot deal stage. For one stage, the Flex quote status decides.

| HubSpot deal stage | Flex quote status | Soundcheck gig |
| - | - | - |
| Quote requested | Any | Draft |
| Quote submitted | Tentative | Active |
| Quote submitted | Any other | Draft |
| Deal won, confirmed in production | Any | Active |
| Closed won | Any | [Settled](https://docs.soundchecklive.io/features/gigs/closeout.md) |
| Closed lost | Any | Cancelled |
| Event postponed or backlog | Any | No change |

Lead and discovery stages leave the gig's status as it is. Postponed and backlog also leave it alone, because the job is expected back. When a synced quote has no linked gig yet, Soundcheck creates one. See the [event lifecycle](https://docs.soundchecklive.io/reference/event-lifecycle.md) for how each status behaves.

## Direction of flow

> [card] Inbound (CRM → Soundcheck)
>
> n8n reads a deal-stage or quote-status change in HubSpot or Flex, normalizes it, and posts it to Soundcheck through a **signed** webhook. Soundcheck updates the quote and moves the gig's status.

> [card] Outbound (Soundcheck → CRM)
>
> After the show, you complete and settle the gig in Soundcheck. n8n runs the settlement workflow that carries the close back to Flex and HubSpot.

## Why n8n owns the external calls

Keeping the pipeline in n8n puts integration logic (auth, rate limits, retries, field mapping) in one place you can change without touching Soundcheck. Soundcheck stays the system of record for the gig itself and trusts only **signed** requests for the right organization.

## Related

> [card] [n8n CRM sync](https://docs.soundchecklive.io/integrations/n8n-crm-sync.md)
>
> The signed-webhook foundation this builds on.

> [card] [Event lifecycle](https://docs.soundchecklive.io/reference/event-lifecycle.md)
>
> How a gig's status moves.

> [card] [Closeout](https://docs.soundchecklive.io/features/gigs/closeout.md)
>
> Completed and settled, the back half of the map.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.