Connecting Integrations

Nummbas supports 19 integrations across ecommerce, payments, advertising, accounting, subscriptions, email marketing, shipping, customer support, and returns. Each integration uses one of several connection methods. You can also add fulfillment costs and overhead expenses manually if your provider or accounting system does not have a direct integration.

Connection Methods

OAuth (One-Click)

Most integrations use OAuth. You click "Connect," sign in to the platform, and authorize Nummbas to read your data. No API keys or credentials needed.

Integrations using OAuth: Meta Ads, TikTok Ads, Google Ads, Pinterest Ads, Snapchat Ads, Square, QuickBooks, Xero, Klaviyo

Custom App (Shopify)

Shopify uses a custom app you create inside your Shopify admin. You grant Nummbas read-only scopes and paste the Client ID and Client Secret into Nummbas. The setup modal includes a guided walkthrough with screenshots. See the Shopify integration guide for the full steps.

Integrations using Custom App: Shopify

API Key

Some integrations require you to create an API key in the platform's settings and paste it into Nummbas.

Integrations using API keys: Stripe, ShipStation, Recharge, BigCommerce, Loop Returns

Personal Access Token

ShipBob uses a Personal Access Token. Generate a token in your ShipBob dashboard under Settings, then API Tokens, and paste it into Nummbas.

Integrations using Personal Access Token: ShipBob

Basic Auth

Gorgias uses Basic Auth. Go to your Gorgias dashboard, then Settings, then REST API. Copy your subdomain, API key, and the email associated with your account, and enter all three in Nummbas.

Integrations using Basic Auth: Gorgias

Instance ID

Wix uses an Instance ID. Install the Nummbas app on your Wix site, then copy the Instance ID from the Nummbas page in your Wix dashboard.

Integrations using Instance ID: Wix

Credentials

WooCommerce uses a Consumer Key and Consumer Secret that you generate in your WooCommerce admin.

Integrations using credentials: WooCommerce

Manual Entry or CSV

If your provider or accounting system is not listed above, you can still track your costs in Nummbas by entering them directly or uploading a CSV.

Manual 3PL / Fulfillment - monthly fulfillment totals (pick and pack, shipping, storage, other fees).
Manual Expenses - overhead and vendor costs by category, useful when you do not connect QuickBooks or Xero or for costs those platforms do not capture.

How to Connect

Go to Dashboard > Integrations
Find the platform you want to connect
Click Connect
Follow the steps for that platform's connection method:
- OAuth: You will be redirected to the platform to sign in and authorize access
- Custom App (Shopify): A guided walkthrough opens with screenshots showing how to create the custom app and copy your Client ID and Secret
- API Key: A modal will appear with instructions on where to find your key
- Instance ID: A modal will appear with instructions on where to find your Instance ID
- Credentials: A modal will appear with fields for your credentials
- Manual Entry or CSV: A modal will open where you name the source, then enter monthly data or upload a CSV file

Tip:

Some OAuth integrations (like Meta Ads, TikTok Ads, Google Ads, and Xero) may ask you to select an account after authorization if you have multiple accounts on that platform.

Integration Limits by Plan

The number of integrations you can connect depends on your plan:

Plan	Total Integrations	Connections per Provider
Starter	3	1
Growth	8	1
Scale	Unlimited	3

Connections per provider means you can connect multiple accounts from the same platform. For example, on the Scale plan, you could connect 3 different Shopify stores.

Data Sync

After connecting an integration, Nummbas will immediately begin syncing your data. The initial sync typically takes a few minutes depending on how much historical data you have.

After the initial sync, data is refreshed automatically on a regular schedule. You can see the last sync time on each integration card in the Integrations page.

Managing Connections

On each connected integration, you can:

View sync status - see when data was last synced and whether there are any errors
Flush data - remove all synced data for that integration and re-sync from scratch (requires password confirmation)
Add another connection - connect additional accounts for the same provider (Scale plan)