Connected Accounts (Enterprise)

Connected Accounts let you create and operate child organizations under your organization (parent). Child organisations also have their own Products, Plans, and Stripe billing. They suit businesses that run Salable on behalf of others, such as resellers, white-label partners, or separate tenants that each need their own Stripe configuration.

Important Connected Accounts is an Enterprise feature. Contact us to learn more.

Create a Connected Account

Open Connected Accounts in the dashboard. Enter a name for your Connected Account (eg "Acme Reseller") and a Stripe Email Address (eg billing@acme-reseller.com), then click "Create Connected Account".

Salable creates the child organisation with an ID prefixed with ca_, while Stripe creates the associated Standard account. Salable links that Stripe account to the child through a Payment Integration. Copy the Organisation ID from the table to use in the Connected-Account header on API requests.

Important The Stripe email is used only to provision the child's Stripe account. Each child has its own Payment Integration, the parent does not share Stripe config with children.

Act As in the Dashboard

To act as a Child Organisation, click Act As on a Connected Account row. The dashboard will be scoped to that child and will show an "Acting as" banner. Use the parent’s Test Mode / Live Mode toggle to switch which child environment you are viewing.

Note Billing and API Keys won't be visible in this view as they belong to the parent.

To finish setting up Stripe for the child organisation, open Payment Integrations (while acting as the child organisation) and copy the onboarding link into a separate tab to complete Stripe's onboarding flow.

When finished, click "Return to parent" on the banner at the top of the screen.

Calling the API as a Child

To use the Salable API as a child organisation, use the Secret Key from the parent organisation and add the Connected-Account header with the child’s Organisation ID as the value. Organization-scoped endpoints will use the child organization instead of the parent.

const response = await fetch('https://salable.app/api/products', {
    method: 'POST',
    headers: {
        Authorization: `Bearer ${process.env.SALABLE_SECRET_KEY}`,
        'Connected-Account': 'ca_01HXYZ...',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Acme Reseller Platform'
    })
});

Important Children have no credentials of their own, so you can't authenticate directly as a child. The only way to act as a child over the API is a parent secret key plus the Connected-Account header, sent from your server. In the dashboard, you can use "Act As" to control a child account.

The child's Test Mode or Live Mode follows the parent secret key you send. Use the parent's Test Mode secret key to operate in the child's Test Mode, and the parent's Live Mode secret key to operate in the child's Live Mode. The child's Organisation ID stays the same in both cases.

Archive, Restore, and Delete

To temporarily freeze a Connected Account, archive it from the dashboard. An archived account remains visible, and its data is still accessible for viewing. However, any attempt to change or update its data, whether through the “Act As” feature in the dashboard or using the Connected-Account header in the API, will be blocked with a 403 error until the account is restored.

Deleting a Connected Account permanently removes the account and all associated Salable data.

Warning Deleting a Connected Account is irreversible.

A Connected Account is not restricted to a single mode. Deleting it will remove all associated data for both Test and Live environments simultaneously. Only the parent organisation that owns the account is permitted to delete it.

Related

• API Keys Secret vs publishable keys, and when to use each.
• Dashboard and Admin Day-to-day organisation management in the Salable dashboard.
• Stripe Payment Methods Enabling payment methods on a Stripe Connect account (separate from Salable Connected Accounts).