SDigital2Bank accounts
Create a bank account
Create a new bank account
AuthorizationBearer <token>
In: header
customerIdstring
Customer UUID
namestring
Label used to identify the bank account
typestring
Bank account type
Value in
"EXTERNAL"railstring
Bank account rail
Value in
"PIX"currencystring
Bank account currency
Value in
"BRL"beneficiaryobject
Bank account beneficiary
accountDetailsobject
Bank account details
Response Body
curl -X POST "https://api.sandbox.sdigital2.com/v1/bank-accounts" \ -H "Content-Type: application/json" \ -d '{ "customerId": "3190d115-987f-402f-b558-0316d3a22ebd", "name": "My Bank Account", "type": "EXTERNAL", "rail": "PIX", "currency": "BRL", "beneficiary": { "relationship": "SELF", "legalName": "Shape Co.", "taxId": "string", "email": "string", "address": { "line1": "123 Avenue", "city": "New York", "state": "NY", "country": "USA" }, "incorporationDate": "2025-12-13" }, "accountDetails": { "keyType": "EMAIL", "keyValue": "john.doe@example.com" } }'{
"id": "3190d115-987f-402f-b558-0316d3a22ebd",
"customerId": "3190d115-987f-402f-b558-0316d3a22ebd",
"name": "string",
"type": "EXTERNAL",
"rail": "PIX",
"currency": "BRL",
"beneficiary": {
"relationship": "SELF",
"legalName": "Shape Co.",
"taxId": "string",
"email": "string",
"address": {
"line1": "123 Avenue",
"line2": "Apt 1",
"city": "New York",
"state": "NY",
"postalCode": "10001",
"country": "USA"
},
"incorporationDate": "2024-12-13"
},
"accountDetails": {
"keyType": "EMAIL",
"keyValue": "john.doe@example.com"
},
"createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z",
"verification": {
"status": "APPROVED",
"level": "BASIC"
}
}