Skip to main content
POST
Assign a cash flow category to transactions
Authentication: API key OAuth 2.0
Scope: cash_flow_category.write
Notes:
  • Up to 100 transactions can be assigned in a single call.
  • When a category has subcategories, you must assign one of its leaf subcategories — assigning the parent category itself is rejected.
  • To clear an existing assignment, use Unassign a cash flow category from transactions.

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json
transaction_ids
string[]
required

UUIDs of the transactions to tag. Up to 100 per call.

category_id
string
required

UUID of the cash flow category (or subcategory) to apply.

Response

Returns the transactions that were updated and the category that was applied.

transaction_ids
string[]
required

UUIDs of the transactions that were updated.

category_id
string
required

UUID of the cash flow category that was applied.