HubSpot
Connect your HubSpot instance to your FastSpring store.
Limited Release
This feature is part of a limited release and may only be available for some eligible users. If you’re interested in connecting your HubSpot instance to your FastSpring store, please email [email protected].
FastSpring + HubSpot integration
The FastSpring + HubSpot integration connects your commerce and CRM platforms. It syncs quote, order, and subscription data from your FastSpring store to your HubSpot instance, helping your team keep customer records up to date and automate key actions.
The integration reduces manual data entry, providing sales, success, and operations teams with the necessary context to manage deals and accounts more efficiently.
It enables teams to:
- Send FastSpring quotes directly from HubSpot deals and automate follow-up emails
- Track quote status changes and update deal stages automatically
- Auto-create contacts, companies, deals, products, and line items from FastSpring orders
- Trigger HubSpot workflows and lifecycle campaigns based on real-time commerce events
- Improve pipeline visibility with synced quote, order, and subscription fields
The integration supports two types of workflows:
-
FastSpring-initiated workflow
Triggered by FastSpring events like orders or subscription updates. Best for self-serve checkout or automated flows. -
HubSpot-initiated workflow
Triggered manually from a HubSpot deal. Best for sales-led quoting workflows where reps generate FastSpring quotes.
What this guide covers
This page explains how to:
- Install and connect the FastSpring + HubSpot integration
- Choose and enable the appropriate workflows
- Understand how quote, order, and subscription data flows between platforms
- Review all supported workflows and the fields they update in HubSpot
Prerequisites
Before installing the integration, confirm that your FastSpring and HubSpot accounts meet the following requirements.
Click to view platform requirements
FastSpring
- Admin access to the FastSpring app
- An active store
- Access to Developer Tools > Extensions
HubSpot
-
HubSpot Starter plan or higher
-
Admin access to your HubSpot account
-
The Preferred country property format setting must be set to Country abbreviation
Settings > Data Management > Objects > Contacts
- The Create and associate Companies with Contacts setting must be enabled
Settings > Data Management > Objects > Companies
Product setup requirements
To sync orders and quotes correctly, each product in HubSpot must be connected to its FastSpring equivalent.
- All HubSpot products must include a
fs_product_path
property that matches a FastSpring product ID. - This requirement applies to both the order and quote workflows.
- When using the order workflow, the integration can auto-create missing products.
- When using the quote workflow only, products must be added to HubSpot manually.
Installation
Follow the steps below to connect your FastSpring and HubSpot accounts and enable integration workflows.
-
Log in to the FastSpring app.
-
Navigate to Developer Tools > Extensions and click the HubSpot tile.
-
In the connection window, click Connect and sign in with your HubSpot credentials.
-
Review the requested access and click Allow to authorize the integration.
You must have admin access on both platforms to complete this step.
-
After connecting, go to the Configuration tab.
-
Review the available workflows and toggle on the ones you want to enable.
Tip: Only enable the workflows that match your team’s setup. For example, if you don’t send quotes via HubSpot, leave the quote workflow disabled.
Property lookup reference
The integration uses these core properties to sync objects between FastSpring and HubSpot.
HubSpot
Property | Object |
---|---|
fs_product_path |
Products, Line Items |
fs_account_id |
Contacts, Companies |
fs_order_id |
Deals |
fs_subscription_id |
Deals |
fs_quote_id |
Deals |
FastSpring
When a quote is generated from HubSpot, FastSpring tags the quote with the HubSpot Deal ID:
Tag | Object |
---|---|
hubspot_deal:DealId |
FastSpring Quote |
Workflows
The integration supports a set of workflows that sync data between FastSpring and HubSpot based on specific trigger events. Each accordion below provides:
- A summary of the workflow's purpose
- Trigger, condition, and action details
- Fields that are created or updated in HubSpot
Click any workflow below to expand and view the full details.
Integration enabled
This workflow runs when the FastSpring + HubSpot integration is connected for the first time. It automatically creates a set of custom properties in your HubSpot instance to support quote, order, and subscription syncing.
Trigger, condition, and action
This table shows what happens immediately after the integration is enabled.
Trigger | Condition | Action |
---|---|---|
integration connected | FastSpring is connected to HubSpot for the first time | Creates custom properties in HubSpot |
Created HubSpot properties
This table lists the custom properties that are added to HubSpot when the integration is enabled.
HubSpot property | Object | FastSpring source |
---|---|---|
fs_product_path |
Product | items.product |
fs_product_sku |
Product | items.sku |
fs_coupon_code |
Line item | items.coupon |
fs_order_id |
Deal | order.id |
fs_order_reference |
Deal | order.reference |
fs_subscription_id |
Deal | items.subscription |
fs_subscription_status |
Deal | subscription.state |
fs_subscription_startdate |
Deal | subscription.begin |
fs_subscription_canceleddate |
Deal | subscription.canceledDate |
fs_subscription_deactivateddate |
Deal | subscription.deactivationDate |
fs_account_id |
Contact, Company | account |
fs_quote_status |
Deal | quote.status |
fs_quote_name |
Deal | quote.name |
fs_quote_create |
Deal | Trigger to create quote |
fs_quote_coupon |
Deal | quote.coupon |
fs_quote_currency |
Deal | quote.currency |
fs_quote_url |
Deal | quote.quoteUrl |
fs_quote_id |
Deal | quote.id |
order.completed
When an order is completed in FastSpring, this workflow automatically creates or updates the appropriate records in HubSpot. It is typically used in e-commerce or self-serve checkout flows where CRM data needs to be populated automatically.
Trigger, condition, and action
This table shows the system behavior when the order.completed
event occurs.
Trigger | Condition | Action |
---|---|---|
order.completed |
A new order is completed in FastSpring | Creates Contact, Company, Deal, Product, and Line Item objects in HubSpot |
Workflow steps
The steps below describe how FastSpring processes and syncs data when the workflow is triggered.
-
Create or assign Contact and Company
If the contact (email) does not exist, create it.
If the company (by domain) does not exist, create and associate it. -
Create Deal
Status: Closed Won
Associated with contact and company
Product check per item:
- Exists? → Use it
- Doesn’t exist? → Auto-create -
Create Line Items
Associate to Deal
Mapped properties
This table lists the specific fields that are synced from FastSpring to HubSpot when the workflow runs.
FastSpring property | HubSpot object | HubSpot property |
---|---|---|
customer.address.country |
Company | hs_country_code |
account |
Company | fs_account_id |
customer.company |
Company | name |
account |
Contact | fs_account_id |
customer.first |
Contact | firstname |
customer.last |
Contact | lastname |
customer.email |
Contact | email |
customer.phone |
Contact | phone |
order.id |
Deal | fs_order_id |
order.reference |
Deal | fs_order_reference , dealname |
order.subscription |
Deal | fs_subscription_id |
subscription.state |
Deal | fs_subscription_status |
subscription.begin |
Deal | fs_subscription_startdate |
subscription.canceledDate |
Deal | fs_subscription_canceleddate |
subscription.deactivationDate |
Deal | fs_subscription_deactivateddate |
item.coupon |
Line Item | fs_coupon_code |
item.product |
Product | fs_product_path |
item.sku |
Product | fs_product_sku , hs_sku |
item.pricing.price.USD |
Product | price |
item.display.en |
Product | name |
item.description.summary.en |
Product | description |
item.image |
Product | hs_images |
item.pricing.interval |
Product | recurringbillingfrequency |
subscription.activated
This workflow runs when a subscription is activated in FastSpring. It ensures that the corresponding deal in HubSpot is updated with the subscription status and start date.
Trigger, condition, and action
This table shows how HubSpot is updated when a FastSpring subscription is activated.
Trigger | Condition | Action |
---|---|---|
subscription.activated |
A subscription is activated in FastSpring | Updates HubSpot deal with status and start date |
Fields updated
The following fields are updated on the HubSpot deal when this workflow runs:
fs_subscription_status
=active
fs_subscription_startdate
= subscription start date
subscription.canceled
This workflow runs when a subscription is canceled in FastSpring. It updates the associated deal in HubSpot to reflect the cancellation and deactivation dates.
Trigger, condition, and action
This table shows what happens when a FastSpring subscription is canceled.
Trigger | Condition | Action |
---|---|---|
subscription.canceled |
A subscription is canceled in FastSpring | Updates HubSpot deal with cancellation and deactivation dates |
Fields updated
The following fields are updated on the HubSpot deal when this workflow runs:
fs_subscription_status
=canceled
fs_subscription_canceleddate
= cancellation datefs_subscription_deactivateddate
= deactivation date
quote.created
This workflow runs when a user creates a HubSpot Quote on a HubSpot deal. A quote is created in FastSpring and synced back to HubSpot.
Trigger, condition, and action
This table shows how a FastSpring quote is generated from HubSpot.
Trigger | Condition | Action |
---|---|---|
A HubSpot Quote is created and user saves it in draft | Deal currency is set | Creates a FastSpring quote and returns the quote URL, ID, and Status to properties on deal |
Requirements
All of the following fields must be present on the HubSpot deal:
- A Contact must be associated with the deal
- A Company must be associated with the deal
- At least one Line Item must be present, and each must have a matching product
fs_quote_currency
must be set
Tip: You can trigger a HubSpot workflow to automatically email the quote URL to a prospect once it's returned.
You can create a quote in any currency that is available from the Deal currency field. Visit the Add and edit your account currencies article to learn how to use multiple currencies in HubSpot.
quote.updated
This workflow runs when a quote that was created via HubSpot is updated in FastSpring. The quote status is synced back to the related HubSpot deal.
Trigger, condition, and action
This table shows how quote status changes in FastSpring are reflected in HubSpot.
Trigger | Condition | Action |
---|---|---|
quote.updated |
Quote created via HubSpot is updated in FastSpring | Updates the fs_quote_status field in HubSpot |
This workflow is useful for moving deals forward in HubSpot or triggering internal notifications when a quote is accepted or paid.
Fields updated
The following field is updated on the HubSpot deal when this workflow runs:
fs_quote_status
= latest status from FastSpring
FAQs
Do I need both workflows enabled?
No. You can enable just the workflow(s) that match your sales model. If you don’t send quotes through HubSpot, you can leave the quote workflow disabled.
What happens if a product doesn’t exist in HubSpot?
If you're using the order workflow, FastSpring will automatically create the missing product. If you're using the quote workflow only, the product must be added to HubSpot manually.
Can I customize the HubSpot fields used by the integration?
Not at this time. All property mappings are fixed and created automatically when the integration is enabled.
Updated 1 day ago