SaaSFlow
DevelopersAPIReferencevendors

Update external id

Replace a vendor's external ids with the list you send. This is a full replacement, not a merge, so include the ids you want to keep.

Authentication

Checking whether you're signed in…
PUT
/companies/{companyId}/vendors/{vendorId}/external-ids

Authorization

headerAuthorization<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.

Path Parameters

companyId*string
Length1 <= length
vendorId*string
Length1 <= length

Request Body

application/json
  1. body
externalIds*array<string>

Response Body

Updated external IDs

application/json
  1. response
externalIds*array<string>
Example Request
curl -X PUT 'https://api.saasflow.com/companies/string/vendors/string/external-ids' \  -H 'Content-Type: application/json' \  -d '{  "externalIds": [    "string"  ]}'
Example Response
{  "externalIds": [    "string"  ]}

List external ids

List the external ids linked to a vendor. These are the identifiers the vendor carries in connected systems, and they are what lets an importer recognise…

Search

Search customers and vendors together by name or domain, returning a light record (id, name, type, domains, logo, default categorization) rather than the…