Merge
Merge duplicate vendors into one. Creates the vendor described in the body, repoints the transactions and external ids of every id in vendorIds onto it…
Authentication
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
1 <= lengthRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/companies/string/vendors/merge" \ -H "Content-Type: application/json" \ -d '{ "vendorIds": [ "string" ], "newVendor": { "name": "string" } }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "name": "string", "defaultCategorization": { "categoryId": "string", "usingDateRule": { "type": "transactionDate" }, "plSplit": { "revenue": 0, "cogs": 0, "cac": 0, "pd": 0, "ga": 0, "no": 0, "neutral": 0 }, "passThroughTax": 0, "transferTargetAccountId": "string" }, "domains": [ "string" ], "logo": true, "autoCreatedSource": "searchApiGoogleWebSearch", "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string", "externalIds": [ "string" ]}Batch delete
Delete many vendors in one call. selection works two ways: mode: "ids" with an explicit list, or mode: "filter" with the same q the list endpoint takes…
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…