SaaSFlow
DevelopersAPIReferenceproducts

List external ids

List the external ids linked to a product. These map the product to its counterpart in a billing system (a Stripe price or product id, for instance), which is how imported subscription events find the right product.

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/products/{productId}/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
productId*string
Length1 <= length

Response Body

application/json

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

Change group

Move one product into a different product group, or send `productGroupId: null` to take it out of every group. Use `/products/reorder` instead when you also need to set the position inside the target group. Fails with 404 if the product or the group does not exist.

Update external id

Replace a product'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 product in the same company is refused with 409, which stops one billing plan mapping to two products.