SaaSFlow
DevelopersAPIReferencecustomers

List external ids

List the external ids linked to a customer. These are the identifiers this customer carries in connected systems (a Stripe customer id, a HubSpot company id, and so on), and they are what lets an importer recognise the same customer across syncs.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
GET
/companies/{companyId}/customers/{customerId}/external-ids

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length
customerId*string
Length1 <= length

Response Body

application/json

curl -X GET "https://example.com/companies/string/customers/string/external-ids"
{  "externalIds": [    "string"  ]}

Merge

Merge duplicate customers into one, in a single transaction. Creates the customer described by `newCustomer`, repoints the transaction categorizations, subscriptions, and external ids of every id in `customerIds` onto it, then deletes the originals. Use this rather than delete when the same account was imported twice: it keeps revenue history and MRR continuous, where a delete would cascade the subscriptions away. Returns the merged customer with its `logoUrl` and combined `externalIds`.

Update external id

Replace a customer's external ids with the list you send. This is a full replacement, not a merge, so include the ids you want to keep. An id already claimed by a different customer in the same company is refused with 409, which keeps imports from splitting one customer across two records.