Skip to main content

Multi-Account Support

The gateway supports multiple accounts per provider per tenant. This is essential for agencies managing multiple client accounts.

How it works

Tokens are stored with an account_id dimension:
For example:
  • tokens:ascend:hubspot:default — Ascend dev portal
  • tokens:ascend:hubspot:kahuna_prod — Kahuna production portal
  • tokens:ascend:google_ads:default — MCC account (manager)

Specifying an account

Pass account_id in your API call:

Safety guard

If a tenant has multiple accounts for a provider and you don’t specify account_id, the gateway returns an error:
This prevents accidentally querying the wrong account. For Google Ads, the gateway automatically injects the login-customer-id header when routing through an MCC:
  • customer_id — the sub-account being queried
  • login_customer_id — the MCC that has access (set in tenant config)