Create an account

Creates a new account associated with the group.

Creating an office (organisational unit): To create an office, include parent_id in the request body. The parent must be a top-level account within the same group — it cannot itself be an office. When parent_id is set, tin_value and tin_scheme are inherited from the parent and must not be provided; sending either field returns 422 Unprocessable Entity.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The account object in JSON format to create

account
object
required

Request body schema for creating an account (POST /accounts).
Extends the shared Account schema with the create-time contract: the fields the API requires on creation are listed in required, and each of those that is nullable in the response schema is re-declared here with their nullable state, since a required field that is non-nullable cannot be sent as null. The response representation keeps Account (where these fields may legitimately be null for legacy/partial accounts).
To create an office (organisational unit), include parent_id in the request. The parent must be a top-level account within the same group — it cannot itself be an office. When parent_id is set, tin_value and tin_scheme are inherited from the parent and must not be provided.

Headers
string
Defaults to 2026-06-26

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration
B2Brouter UI Application -> Developers -> API Keys -> API Version

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json