Create Pix Trusted Contact
POST/pix/trusted-contacts
Create a new pix trusted contact. This endpoint is used to create a new pix trusted contact for the user.
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.
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
- application/json
Body
required
- NATURAL_PERSON.
- LEGAL_PERSON.
Pix trusted contact name.
Pix trusted contact CPF or company CNPJ (only numbers)
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Pix trusted contact person type:
Pix trusted contact branch number.
Pix trusted contact account number.
Possible values: [CACC, CASH, CHAR, CISH, COMM, CPAC, LLSV, LOAN, MGLD, MOMA, NREX, ODFT, ONDP, OTHR, SACC, SLRY, SVGS, TAXE, TRAN, TRAS, CC, PG, CD, CG, CI, PP]
Pix trusted contact account type.
Pix trusted contact bank ISPB.
Pix trusted contact bank name.
Responses
- 201
- 400
- 401
- 422
Pix trusted contact created.
- application/json
- Schema
- Example (from schema)
Schema
Pix trusted contact ID.
Pix trusted contact created date.
{
"id": "56007975-3e29-4b57-b5b9-d32d331fd820",
"created_at": "2025-10-22T19:11:19.367Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.