Skip to Content
SaaSFlow
DevelopersAPIReferencecategorization_suggestions

Apply

Apply a reviewed batch of categorization suggestions in one call. Counterparties that do not exist yet go in vendorsToCreate and customersToCreate with a…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/categorization_suggestions/apply

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
Formatuuid

Request Body

application/json
  1. body
suggestions*array<>
vendorsToCreate?array<>
Default[]
customersToCreate?array<>
Default[]

Response Body

Suggestions applied

application/json
  1. response
appliedSuggestions*number
appliedTransactions*number
skippedTransactions*number
createdVendors*array<>
createdCustomers*array<>
Example Request
curl -X POST 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/categorization_suggestions/apply' \  -H 'Content-Type: application/json' \  -d '{  "suggestions": [    {      "categoryId": "337f5e5d-288b-40d5-be14-901cc3acacc0",      "usingDateRule": {        "type": "transactionDate"      },      "plSplit": {},      "transactionIds": [        "390bdf4e-83f8-4d97-9b70-6548dddef7ab"      ]    }  ]}'
Example Response
{  "appliedSuggestions": 0,  "appliedTransactions": 0,  "skippedTransactions": 0,  "createdVendors": [    {      "tempId": "string",      "id": "string",      "name": "string"    }  ],  "createdCustomers": [    {      "tempId": "string",      "id": "string",      "name": "string"    }  ]}