Skip to main content
POST
Create a cash flow category

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
name
string
required

Display name of the new category. Must be non-empty.

type
enum<string>
required

Direction of the category:

  • CATEGORY_TYPE_INFLOW: money coming in
  • CATEGORY_TYPE_OUTFLOW: money going out
Available options:
CATEGORY_TYPE_INFLOW,
CATEGORY_TYPE_OUTFLOW
vat_rate
string

Optional VAT rate, as a decimal string (for example 20 or 5.5). Omit to create a category with no associated VAT rate.

Response

Returns the created cash flow category. Its subcategories array is always empty.

cash_flow_category
object
required

A cash flow category. Categories carry a stable id that the cashflow_category.id field on transactions refers to, letting you reconcile categories against an external chart of accounts.