SaaSFlow
DevelopersAPIReferencecustomers

Delete customer

Delete a customer. This reaches further than it looks: their subscriptions are cascade-deleted, which changes MRR history, and any planned transaction pointing at them is unassigned. Transactions survive but lose their counterparty, and each one is flagged to stay out of auto-categorization so the deleted customer is not immediately re-matched. For a duplicate record, merge instead of deleting.

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.
DELETE
/companies/{companyId}/customers/{customerId}

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 DELETE "https://example.com/companies/string/customers/string"
{  "success": true}

Retrieve customer

Retrieve a single customer by id. Returns 404 if the customer does not exist or belongs to another company.

Update customer

Update a customer. Only the fields you send change. Changing `defaultCategorization` affects future categorizations only; transactions already categorized keep what they have.