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

Country code setting

  • The Create and associate Companies with Contacts setting must be enabled
    Settings > Data Management > Objects > Companies

Associate 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.

  1. Log in to the FastSpring app.

  2. Navigate to Developer Tools > Extensions and click the HubSpot tile.

    Developer Extensions

  3. In the connection window, click Connect and sign in with your HubSpot credentials.

  4. Review the requested access and click Allow to authorize the integration.

    You must have admin access on both platforms to complete this step.

    OAuth Dialog

  5. After connecting, go to the Configuration tab.

  6. 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.

  1. 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.
  2. Create Deal
    Status: Closed Won
    Associated with contact and company
    Product check per item:
        - Exists? → Use it
        - Doesn’t exist? → Auto-create
  3. 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 date
  • fs_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.