Documentation

Guides for connecting Stripe and HubSpot and configuring your sync.

• Quickstart — Connect Stripe and HubSpot, run your first backfill, and watch data flow — start to finish in a few minutes.
• What syncs to what — The complete map of how Stripe objects become HubSpot records — customer routing, subscriptions, invoices, and line items.
• HubSpot associations — Every association the sync creates between HubSpot records — company↔contact, subscriptions, invoices, and line items — and when each is made.
• Connecting HubSpot — Connect HubSpot by OAuth or a Private App token, grant the right scopes, and understand portal validity and Commerce Hub gating.
• Connecting Stripe — Connect Stripe via Stripe Connect OAuth or a pasted secret/restricted key, set the webhook signing secret, and verify access.
• Connecting Slack — Connect Slack via "Add to Slack" OAuth or a pasted Incoming Webhook URL, pick the single channel, and verify with a test message.
• Field mappings & write policies — Map any Stripe value into any HubSpot property, translate enum values, and set per-field write policies so syncs never clobber what your team owns.
• Custom fields — The opt-in stripe_* custom properties the sync writes to HubSpot, grouped by object, and how to create them.
• Sync behavior & limitations — How the sync handles edge cases and HubSpot's constraints — duplicates, read-only fields, negative line items, billing frequency, voided invoices, and more.
• Running syncs — Start a backfill or reconcile, understand the async worker model, read per-record results, and know when the nightly reconcile runs.
• Webhooks — Receive real-time Stripe changes inbound, and emit signed events to your own servers outbound, with retries and a delivery log.
• Slack notifications — Post Stripe billing events — failed payments, churn, new customers, plan changes, and out-of-band invoices — straight into a Slack channel, with a customizable message body.
• API & authentication — Authenticate with an API key, then use the v1 API with idempotency, cursor pagination, and rate limits.
• Example reports & workflows — Ready-to-build HubSpot reports and automation workflows that use your synced Stripe data.