Skip to main content
SubscriptionFlow Docs
HubSpot

Data Sync Configuration

Updated

What this integration does

HubSpot is your CRM (where your sales and marketing live). SubscriptionFlow is where your subscriptions,

 invoices and billing live. The integration keeps the two talking to each other so you never have to copy data by

hand.

Once connected, it builds a two-way data bridge:

  • HubSpot → SubscriptionFlow: new and updated CRM records (companies / contacts) flow into SubscriptionFlow as customers.
  • SubscriptionFlow → HubSpot: your customers — and optionally products, subscriptions and invoices — flow back into HubSpot.

The sync runs in the background. You set it up once, and from then on changes are pushed automatically. You can also run a one-time migration to sync everything you already have.

How to connect HubSpot

Connecting takes about a minute. Let me explain it to you step by step

  1. Go to the HubSpot marketplace and search for SubscriptionFlow.

    marketplace search.png

  2. Click on the install button.

    new.png

  3. After Clicking the install buttonyou have to fill the form for the first time you install the app from the marketplace .
    Lead capture .png

  4. Once the form is filled it will redirect you to the SubscriptionFlow **Login page.**Log in to
    Your SubscriptionFlow account.

    Step 1 — Sign in to your SubscriptionFlow account.

  5. To connect the Hubspot with the subscriptionFlow please follow the guideHubspot Integration guide

Already connected? If HubSpot shows under "Apps connected"  you can skip straight to choosing your business model below.

The HubSpot integration page once connected. The header shows Enabled / Disable / View Logs / Disconnect, and the main panel is where you configure everything.

The HubSpot integration page once connected. The header shows Enabled / Disable / View Logs / Disconnect, and the main panel is where you configure everything.

Choosing your business model

In the HubSpot Integration Page→ Business Model, choose how SubscriptionFlow maps HubSpot records to customers:

  • B2B Companies (organizations)
  • B2C Contacts (individuals)
  • Hybrid Automatic (both)

If unsure, pick what matches most of your sales; use****Hybrid when you sell to businesses and individuals in similar volume.

B2B — selling to companies

Choose B2B when your customers are businesses. In this mode:

In HubSpot In SubscriptionFlow
Company ↔ Customer
Contact (people at that company) ↔ Contact (linked to the customer)

So a HubSpot Company becomes a Customer in SubscriptionFlow, and the people who work there come across as that customer's contacts.

B2B mode selected. The data bridge shows Companies → Customers and Contacts → Contacts, with both real-time directions switched on.

B2C — selling to individuals

Choose B2C when your customers are individual people. In this mode:

In HubSpot In SubscriptionFlow
Contact (a person) ↔ Customer

Each HubSpot Contact maps one-to-one to a Customer in SubscriptionFlow. There are no companies in the middle — perfect for direct-to-consumer subscriptions.

B2C mode selected. The data bridge maps Contacts → Customers, one person per customer.

Hybrid — a mix of both

Choose Hybrid when some customers are companies and others are individuals. SubscriptionFlow looks at the Company field on each customer record and routes it automatically:

SubscriptionFlow customer Synced to HubSpot as
Has a Company name filled in → Company (B2B)
Company field is empty → Contact (B2C)

The Company field is filled in from the Customers module or from your Hosted Checkout pages, so routing happens with no extra work from you.

One-way only. Hybrid mode pushes data from SubscriptionFlow → HubSpot only. It does not pull records back from HubSpot. If you need two-way sync, use B2B or B2C instead.

Hybrid mode selected. Customers with a company name route to Companies; customers without one route to Contacts.

Setting the sync direction

Under Real-time Data Bridge you'll find two switches (B2B and B2C show both; Hybrid shows only the outbound one):

  • HubSpot to SubscriptionFlow — turn this on to pull new and updated records from HubSpot into SubscriptionFlow automatically.

  • SubscriptionFlow to HubSpot — turn this on to push new and updated records from SubscriptionFlow into HubSpot automatically.

    real bridge.png

Field mapping

Field mapping decides which HubSpot field fills which SubscriptionFlow field (and the other way around). Click View Mapping next to "Data Mapping" to open the mapping window.

You'll see two columns — a HubSpot field on the left, the matching SubscriptionFlow field on the right. Pick the HubSpot field for each row from the dropdown, then save.

The field mapping window. Match each SubscriptionFlow Customer field to the corresponding HubSpot field.

Running a migration (one-time sync)

Real-time sync only handles changes from now on. To bring across the records you already have, run a migration.The migration window. Pick a direction, confirm the model, choose what to sync, then start.

The migration window. Pick a direction, confirm the model, choose what to sync, then start.

Monitoring with logs

Click View Logs in the header to see exactly what's been syncing.

The Integration Logs view. Filter and search every sync event in both directions.

Managing the connection

The buttons in the header let you control the connection at any time:

Button What it does
Enabled / Disable Pauses or resumes all automatic syncing without removing the connection.
View Logs Opens the sync activity history (see above).
Disconnect Fully removes the HubSpot connection and revokes access. You'd reconnect from scratch to use it again.

Frequently asked questions

Can I switch business models later?

Yes. Pick a different card under Business Model and save. Remember that Hybrid is outbound-only, so switching to it turns off the inbound pull.

Will it create duplicates?

No — records are matched (for example, by email) so existing customers are updated rather than duplicated.

Do I need to map fields before I start?

No. Core fields sync automatically with sensible defaults. Mapping is optional and only needed for custom fields or fine-tuning.

How quickly do changes sync?

Automatic syncs run in the background in near real time. Large one-time migrations run as a background job and show progress on the page.

Where do I see errors?

In View Logs — filter by Status → error to see only the failures, then click a row for the details.

Was this article helpful?0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.