Skip to main content
POST
/
payments
/
banks
/
add
Add Bank
curl --request POST \
  --url https://api.breet.io/v1/payments/banks/add \
  --header 'Content-Type: application/json' \
  --header 'X-Breet-Env: <api-key>' \
  --header 'x-app-id: <api-key>' \
  --header 'x-app-secret: <api-key>' \
  --data '
{
  "id": "39",
  "accountNumber": "3154021148",
  "narration": "Breet withdrawal"
}
'
{
  "message": "bank added",
  "success": true,
  "data": {
    "id": "69737920df8b52679a8b198e",
    "account": "69547e78ab637caab7d7839c",
    "user": "68ca0d24604d65932aac2fc8",
    "accountName": "CHIROMA AHMED OLABANJI",
    "accountNumber": "3154021148",
    "autoSettlement": false,
    "bankId": "39",
    "bankName": "United Bank For Africa",
    "createdAt": "2026-01-23T13:35:27.948Z",
    "currency": "ngn",
    "disabled": false,
    "integration": "692d994b7ca6e4da422363fb",
    "isBusiness": true,
    "narration": "Breet withdrawal",
    "type": "nuban",
    "updatedAt": "2026-01-23T13:35:27.948Z"
  },
  "meta": {},
  "summary": {},
  "stats": {}
}

Authorizations

​
x-app-id
string
header
required

Your application ID from the Breet dashboard

​
x-app-secret
string
header
required

Your application secret from the Breet dashboard

​
X-Breet-Env
string
header
required

Environment selector: development or production

Body

application/json
​
id
string
required

The bank ID from the Fetch Bank List endpoint.

Example:

"39"

​
accountNumber
string
required

The bank account number to add.

Example:

"3154021148"

​
narration
string

Optional narration that appears on the bank statement for withdrawals (max 32 characters).

Example:

"Breet withdrawal"

Response

200 - application/json

Bank added successfully