Sync your platforms

One page for every platform

Platforms in the sidebar is where you connect everything you sell and advertise on. One card per platform: its logo, whether it is working, and the one button that matters right now.

Search by name, or filter by status. Only the filters that would actually show something are offered, so an empty one never wastes a click.

What each status means

The band across the top of a card is the whole answer.

Out of sync is not always a fault. Draft2Digital only refreshes while a browser is open. Your ad platforms refresh when you open TrueRoyalties and, at the latest, once a day on their own. KDP, Kobo, ThriveCart, Fourthwall, Squarespace, WooCommerce, Shopify and Apple Books refresh on their own server schedule regardless. Coming back after a day away and seeing amber usually just means your figures are a day old, and the next sync fixes it.

What you can connect today

Meta and TikTok have their own pages in the app, where you decide which ad accounts count and which book each ad belongs to. The card sends you there rather than repeating those controls.

ThriveCart

In ThriveCart, open Settings, then API & webhooks, then API tokens, and create a token. Paste it in the window that opens when you click Connect. We check it with ThriveCart before saving it, then import your whole sales history — a few minutes on a large account.

Each product, bump, upsell and downsell you sell becomes a title in Books. How the figures are counted:

• Amounts are what ThriveCart records, before your payment processor's fees and any affiliate commissions. They will read higher than what reaches your bank.
• A payment plan or subscription counts one sale. Each later instalment adds money, not another copy.
• A refund is subtracted on the day it happens. A full refund also takes the sale back out.
• Test purchases are never imported.

ThriveCart does not say where a buyer lives, so these sales are not tied to a country.

Fourthwall

In Fourthwall, open Settings, then For developers, then Open API, and press Create API user. Copy the username and password it shows — only a shop super admin can create them — and paste both in the window that opens when you click Connect. We check them with Fourthwall before saving them, then import your whole order history.

Each product you sell becomes a title in Books — digital products as ebooks, the rest as print. How the figures are counted:

• Amounts are your profit on each product: what the buyer paid, less any discount and the production cost Fourthwall charges you. Shipping and tax are left out.
• A product Fourthwall sends without a production cost counts at its full price, and the Fourthwall page in the app tells you so.
• A cancelled order is removed, and completed donations are added.
• Payment fees, partial refunds and membership payments are not included — Fourthwall's API does not provide them.
• Gift card sales and your own sample orders never count. A gift card counts when a buyer spends it.

Sales are dated on the day the order was placed (UTC) and are not tied to a country.

Squarespace

In Squarespace, open Settings, then Developer Tools, then Developer API Keys. Generate a key with Orders and Transactions set to read only, copy it straight away — it is shown only once — and paste it in the window that opens when you click Connect. We check with Squarespace that the key can read your orders before saving it, then import your whole order history. Squarespace documents API keys for sites on its Commerce Advanced plan.

Each product you sell becomes a title in Books — physical products as print, the rest as ebooks. How the figures are counted:

• Amounts are what buyers paid for your products, after discounts, without tax or shipping. Payment processing fees are not deducted.
• Prices that include VAT have it taken out, using the tax Squarespace recorded on the order.
• A refund takes back its share of the order. A full refund removes the sale; a partial one keeps it.
• Only paid orders count. Unpaid, cancelled and test orders are left out, and a payment plan counts once it is fully paid.
• Donations are included when the key can read transactions; otherwise the Squarespace page in the app tells you they are missing.
• Gift card sales and orders imported from other sales channels never count. A gift card counts when a buyer spends it.

Sales are dated on the day the order was placed (UTC) and are not tied to a country.

WooCommerce

Sign in to WordPress as an administrator, then click Connect and enter your store's address. We send you to your own store to approve read-only access — nothing to create by hand, no key to copy. As soon as your store confirms the access, we import your whole order history.

Each product you sell becomes a title in Books — downloadable and virtual products as ebooks, the rest as print. How the figures are counted:

• Amounts are what buyers paid for your products, after coupons, without tax or shipping. Payment processing fees are not deducted.
• A refund comes off the line it refunds. Refund one book of two and one unit and its price come off that book. A refund of an amount with no products named is shared across the order's products.
• Only paid orders count. Pending, on-hold (a bank transfer not received yet), cancelled and failed orders are left out, and an order you move to the bin leaves your figures at the next sync.
• Gift card sales never count. A gift card counts when a buyer spends it.

Sales are dated on the day the order was placed (UTC) and are not tied to a country. Your store needs WordPress's pretty permalinks turned on.

Shopify

Shopify is read through a small app you create for your own store, once:

1. In the Shopify Dev Dashboard, create an app.
2. Give its version the read_orders and read_products access, release it, then install the app on your store.
3. In the app's Settings, copy the Client ID and the Client secret.

Click Connect, enter your store's address — the one ending in .myshopify.com, even if your store uses its own domain — and paste the two values. We check with Shopify that the app can read your orders and products before saving anything, then import your order history.

Shopify only shows an app the last 60 days of orders unless it also has the read_all_orders access, which Shopify grants on request. Without it, the Shopify page in the app says so; once it is granted, your older sales are imported automatically.

Each product you sell becomes a title in Books — products that ship as print, the rest as ebooks. How the figures are counted:

• Amounts are what buyers paid for your products, after every discount, without tax or shipping — also when your prices include VAT. Payment processing fees are not deducted.
• A refund takes back what it refunds. Refund one book of two and one unit and its price come off that book. A refund typed as an amount, with no product picked, comes off the order's products by their share.
• Only paid orders count. Pending (a manual payment not received yet), cancelled, test and fully refunded orders are left out.
• An ebook and a paperback are two books, even when you sell them as two variants of one product.
• Gift card sales never count. A gift card counts when a buyer spends it.

Sales are dated on the day Shopify processed the order (UTC), in your store's currency, and are not tied to a country.

Apple Books

In iTunes Connect, open the reports page under Sales and Trends, generate a Reporter access token and paste it in the window that opens when you click Connect. We ask Apple whether the token opens your publisher account before saving anything, then import the whole year of daily reports Apple keeps.

Two things about that token, both Apple's rules: it expires after 180 days, and there is one per Apple Account — generating a new one anywhere kills ours on the spot. The card warns you before the 180 days are up, and says Reconnect when Apple refuses it.

Each book Apple sells becomes a title in Books, with the format Apple reports (ebook or audiobook). How the figures are counted:

• Amounts are Apple's own estimate of what you will receive — its guide says so — per book and per country, after Apple's commission. Taxes and withholding are not in these lines, and Apple's definitive monthly statement is not read yet.
• Free downloads are never sales. They appear in your free units, never in your royalties.
• A correction comes off the day Apple restates it. Apple can restate a day after the fact; every pass re-reads the last few days for exactly that.
• A day with no sale is a day, not a failed sync.

Sales are dated on the day of Apple's report (UTC) and carry the country of the purchase, so they appear on the map and in Marketplaces. Apple keeps 365 days of daily reports: nothing older can be imported.

Sync now

Sync now asks for a refresh immediately instead of waiting for the automatic one. Two things are worth knowing:

• Amazon Ads accepts one manual sync per hour. Past that the button tells you when the next one will be accepted, rather than pretending.
• A sync is not instant. Amazon builds the report on its own schedule, so a refresh usually takes a few minutes to land. Nothing to press while you wait.

You rarely need it — everything refreshes on its own, as described in Sync and data freshness.

Managing a connected platform

Every platform you can connect today has its own page in the app — click its card to open it. There you can:

• Disconnect — stops us reading and removes the session or key we held, but keeps your figures. Useful if you are changing computers or Amazon accounts.
• Erase your data — disconnects and deletes everything that platform ever contributed, permanently. Use it if you connected the wrong account.

Platforms you can connect early

Seventeen more platforms are already connectable, ahead of us reading them. Nothing enters your figures yet — the card reads Connected ✓ — syncing soon — but the day a platform's reading ships, it starts importing with no further action from you. You can disconnect at any time in the meantime.

What Connect does depends on the platform:

Three limits worth knowing before you try:

• BookFunnel's API is only on the Bestseller and Publisher plans, and BookFunnel support has to switch it on for your account.
• Amazon Attribution is not offered on Amazon Australia or Japan. If all your Amazon Ads accounts are there, the card tells you so.
• Square shows Coming soon until its connection opens. From then on its sales are read directly from our servers every 4 hours, and a refund comes off on the day it is made.

One platform — Smashwords — is still marked Coming soon: genuinely not connectable yet, with nothing to click.