Paddle Sync: Subscriptions & MRR

Install it free · Setup guide · Plans and pricing

Paddle Sync is a HubSpot app for software companies that bill through Paddle Billing. It listens to your Paddle account and writes each customer’s subscription data to the matching HubSpot contact and company: plan, status, MRR and ARR, next billing date, trial end date, cancellation date, last failed payment, lifetime value and seats. Cards on the contact and company show the same data and the last payments. Because the data lives in ordinary HubSpot properties, your team can use it in lists, reports and workflows.

Paddle Sync is an app for HubSpot by Kayabyte. It installs directly from this site. Every new account gets the Scale plan for 14 days, no card needed. Not affiliated with Paddle.com.

What HubSpot and Paddle already do, and where this app fits

HubSpot’s own Stripe connection is for Stripe. HubSpot’s help centre names only HubSpot payments and Stripe as payment processors for its commerce tools, and Paddle is not one of them. Paddle’s documentation lists HubSpot among the tools you can share Subscription Metrics data with; the guides explain how to check what that writes, and how to do the job with a CSV export or a no-code tool. This app is for teams that want live, event-based subscription data in HubSpot without building and maintaining the pipe themselves.

What it does

• Connect with an API key. You paste a Paddle Billing API key in the app’s settings. Sandbox and live keys are told apart by their prefix, and the settings and cards say which one is connected. The app creates one notification destination in your Paddle account and verifies the signature of every event it receives.
• Import what already exists. After you connect, the app imports your customers, subscriptions and the last 12 months of transactions in the background and shows progress in the settings.
• Live updates. New subscriptions, upgrades and downgrades, pauses, cancellations, and failed and completed payments update HubSpot within about a minute in our tests. A refund counts once Paddle has approved it; we have not seen an approved refund live, only the event shape.
• Properties on contacts and companies. A property group called Paddle with 13 properties: Paddle customer ID, plan, subscription status, MRR, ARR, currency, next billing date, trial end, cancellation date, first payment, lifetime value, last failed payment and seats.
• MRR and ARR you can explain. Billing periods are normalised to a month, discounts are subtracted, tax is left out, and each currency is kept apart. See how it is calculated.
• Cards. A card for the contact and one for the company, with plan, status, MRR and ARR, next billing date, trial end, recent payments and a link to the customer in your Paddle dashboard. The company card sums every linked customer and lists each subscription.
• Timeline notes. Short notes on the contact and company for a subscription started, upgraded or downgraded, a failed payment, a cancellation and an approved refund or chargeback.
• Optional deals. If you switch it on, the app keeps one deal per subscription in a pipeline you choose, with the amount set to ARR and a stage for each subscription status that you map.
• Matching rules. Contacts are matched by email. Companies come from the company already associated with the contact, otherwise from the email domain. See matching rules.

How MRR and ARR are calculated

• Each subscription item counts its price times its quantity per billing cycle. A cycle can be a day, week, month or year, and a multiple of these (for example every 3 months).
• The cycle is turned into a month: a year is divided by 12, a week is multiplied by 52 and divided by 12, a day is multiplied by 365 and divided by 12, and a multiple is divided by its frequency. A yearly plan of 1,200 is MRR 100 and ARR 1,200.
• Discounts that are in force are subtracted. Tax is excluded. When a price includes tax, or the buyer’s country decides it, the app asks Paddle for the amount before tax, so you do not get a gross figure.
• Only subscriptions with the status active or past due count towards MRR. Trialing, paused and canceled subscriptions show MRR 0.
• Amounts are kept per currency, with no exchange-rate conversion. On a contact or company with several currencies, the money properties carry the currency with the largest MRR and the card lists the others.
• If a discount runs out, MRR returns to the full amount when the next renewal is processed.

How customers are matched

• A Paddle customer becomes a HubSpot contact by email address: an existing contact is updated, otherwise one is created.
• The company is, in this order: the company already associated with the contact, the company the app linked earlier, a company named in a Paddle custom data key that you choose in the settings, and a company with the same email domain.
• The app does not create or match companies for free-mail domains such as gmail.com or outlook.com. You can switch company creation, and contact creation, off in the settings.
• Several Paddle customers can end up on one company, and the company totals add them up.

What it writes to HubSpot

• Properties on contacts and companies (the 13 above), only when a value has changed.
• Timeline notes on the contact and the company.
• Optionally one deal per subscription, with the amount set to ARR.
• It does not write to HubSpot’s own Subscriptions object. That object belongs to HubSpot’s billing tools.

Plans

Free: up to 50 active subscriptions. Growth is USD 29 per month: up to 500. Scale is USD 79 per month: up to 5,000. Above that, contact us. Active subscriptions are those that are active, trialing or past due. Every new account gets 14 days of Scale, no card needed. If you go over your limit, subscriptions already synced keep syncing, new ones are not added, and the settings show an upgrade prompt. See plans and pricing.

What it does not do

• It works with Paddle Billing only. It does not support Paddle Classic.
• It does not send anything to Paddle: it reads customers, subscriptions and transactions. The one thing it changes in Paddle is the notification destination it creates, which it removes when you disconnect.
• It does not convert currencies.
• It does not write to HubSpot’s Subscriptions object and does not create invoices or send email.
• A subscription first seen while you are over your plan limit is held back, not synced, until there is room.
• After a discount ends between two renewals, MRR changes at the next renewal, not on the day it ends.
• A failed renewal is shown as past due and as a failed-payment date. We could not produce a failing renewal in Paddle’s sandbox, so that path is covered by tests and real event shapes, not a live run.

Your data

The app stores your Paddle customers (ID, email, name), subscriptions, the last 12 months of transactions, its settings and your Paddle API key, encrypted, on Cloudflare with the database in Europe. Raw Paddle events are kept for 14 days. The synced records stay until you disconnect and delete the data, or uninstall the app, which deletes everything. Details are in privacy and data.

FAQ

Does HubSpot have a Paddle integration? Not in its commerce tools: HubSpot’s help centre names HubSpot payments and Stripe as its payment processors. Paddle’s documentation lists HubSpot among the tools Subscription Metrics data can be shared with. Paddle Sync is a separate app that writes live subscription data to contacts, companies and, optionally, deals.

Does it work with Paddle Classic? No. It works with Paddle Billing and a Paddle Billing API key.

Can I try it without touching live data? Yes. Paste a sandbox API key and the app connects to your Paddle sandbox. The settings and cards show that a sandbox is connected.

How is MRR calculated? Per subscription: price times quantity, turned into a month, minus discounts, with tax left out, per currency. Trialing, paused and canceled subscriptions count as 0.

Which API key permissions does it need? Read access to customers, subscriptions, transactions and adjustments, and read and write access to notification settings, so it can create its webhook destination.

What happens when I pass my plan limit? Existing subscriptions keep syncing, new ones are not added until you upgrade or free up a place, and the settings show an upgrade prompt.

What does it cost? Free up to 50 active subscriptions; Growth USD 29 per month up to 500; Scale USD 79 per month up to 5,000; 14 days of Scale on install, no card.

Is it on the HubSpot Marketplace? Not yet. It installs from this site, and HubSpot shows an unverified-app notice until it is listed. The setup guide explains it.

More

• Setup guide: install, API key, import, cards, deals, workflows, disconnect
• Plans and pricing
• Privacy and data, security, data processing agreement and sub-processors
• Terms of service
• Guides for HubSpot admins
• Support: support@kayabyte.dev

HubSpot is a registered trademark of HubSpot, Inc. Paddle is a trademark of Paddle.com, used here only to say which service the app connects to. Kayabyte is an independent developer and is not affiliated with or endorsed by HubSpot or Paddle.com.