Create vendor
Create a vendor. defaultCategorization is the template applied to every future transaction matched to this vendor: category, date rule, P&L split, and…
Authentication
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.
companyId*stringuuidapplication/json- body
name*string1 <= lengthdefaultCategorization?|nulldomains?array<string>logo?booleanfalseCreated vendor
application/json- response
id*stringuuidcompanyId*stringuuidname*stringThe name of the vendor.
defaultCategorization*|The default categorization to apply to transactions from this vendor.
domains*array<string>An array of website domains associated with this vendor.
logo*booleanFlag indicating if a logo is available for this vendor.
autoCreatedSource*|The source from which this vendor was automatically created.
"searchApiGoogleWebSearch""stripe""hubspot""datevPayroll""finway""pleo""digistore24""paypal"nullcreatedTime*|date-timecreatedUserId*string|nulllastUpdatedTime*|date-timelastUpdatedUserId*string|nullexternalIds*array<string>External IDs (URNs) linked to this vendor (e.g., DATEV Payroll).
curl -X POST 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/vendors' \ -H 'Content-Type: application/json' \ -d '{ "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" ]}List vendors
List vendors, each enriched with the number of transactions booked against it (nrTransactions), the date of its latest settled transaction…
Linked systems
The integrations at least one vendor is linked to, as the values the list endpoint accepts for linkedTo (e.g. ["finway", "hubspot"]). Empty when no vendor…