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.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- application/json
Body
required
Create user account payload.
- PF
- PJ
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]
User state.
User created date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "active",
"created_at": "2025-12-12T22:44:47.961Z"
}
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.