Create User Account
POST/v2/users/accounts
Create an user account. User account is a base for all other entities. It must be created as first entity.
Request
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
- application/json
Body
required
Create user account payload.
- Natural Person
- Legal Person
Responses
- 201
- 400
- 401
- 403
- 409
- 422
User account created.
- application/json
- Schema
- Example (from schema)
Schema
User account ID.
Possible values: [pending, active, expired, deactivated, deleting]
User state.
User created date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "active",
"created_at": "2026-03-26T14:02:59.121Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the authenticated user does not have permission.
If a user account with the provided document or email or phone number already exists.
If any required params are missing or has invalid format or type.