Create Pix Trusted Contact
POST/v1/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.
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.
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": "2026-03-26T14:02:58.619Z"
}
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.