For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardGet an API key
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
  • Setup
    • Overview
    • Create your workspace
    • Invite your team
    • Roles and permissions
    • Branding and logos
    • Portal settings
    • Connect your CRM
    • Plans and seats
    • Payment method
    • Invoice access
LogoLogo
DashboardGet an API key
On this page
  • Which one should you connect?
  • Pick one, not three
  • When new CRM customers appear in Pivotal
  • The mapping gotcha
  • Related
Setup

Connect your CRM

HubSpot, Salesforce, or Stripe. Pick the one that owns your customer list and connect that.
|View as Markdown|Open in Claude|
Was this page helpful?
Previous

Portal settings

Next

Plans and seats

Built with

Pivotal supports three CRM connectors: HubSpot, Salesforce, and Stripe. Pick the system where new customers land first. That system becomes the source of truth for customer names, domains, and primary contacts. Pivotal writes back state changes (active, at-risk, churned) but does not create or rename customers in the CRM.

Connect from Admin > Integrations. Per-connector setup detail lives under Integrations.

Which one should you connect?

HubSpotSalesforceStripe
Use whenCS lives in HubSpot, sales-led motionEnterprise CRM, complex object modelPLG / self-serve, billing is the signal
What syncs inCompanies > Customers, ContactsAccounts > Customers, ContactsCustomers > Customers, no contacts
What syncs outCustomer state, owner, planCustomer state, owner, planCustomer state only
Sync frequencyReal-time webhooks + nightly reconcile15-min poll + nightly reconcileReal-time webhooks
Custom fieldsYes, mapped per-propertyYes, mapped per-fieldNo
AuthOAuth, you click throughOAuth + connected app permissionsOAuth, restricted API key
First-sync time10-30 min for typical books30-90 min for typical booksUnder 5 min

Pick one, not three

The supported pattern is one connector per workspace. Connecting HubSpot and Stripe at the same time creates duplicate customer records when a domain matches across both. If you need to reconcile two systems, leave one off and use data export plus the API to push the second source’s signal into Pivotal as field updates on the existing customer.

The exception: Stripe as a billing-signal source alongside HubSpot or Salesforce as the customer source. Connect HubSpot first, then connect Stripe with the Billing signal only toggle in the Stripe setup flow. Pivotal then attaches Stripe MRR to existing customers via domain match and does not create new ones.

When new CRM customers appear in Pivotal

HubSpot and Stripe push via webhook; expect new customers in Pivotal inside a minute. Salesforce polls every 15 minutes. The nightly reconcile (3am workspace time) catches anything the webhook missed, plus syncs field changes that don’t fire webhooks (e.g. contact title updates in HubSpot).

The mapping gotcha

Pivotal’s customer.name maps to HubSpot’s company name, Salesforce’s account Name, and Stripe’s customer name field. If your CRM stores legal entity names (“Acme Corporation, Inc.”) and your team uses display names (“Acme”), set the display name explicitly under Admin > Integrations > [provider] > Field mapping before the first sync. Renaming after the fact is fine but each rename writes back to the CRM unless you flip the writeback toggle off.

Related

  • Connect HubSpot
  • Connect Stripe
  • Field mapping

Email help@pivotal.app with a screenshot of where you got stuck and the customer or onboarding id from the URL.