Skip to main content
POST
/
accounts
Create a bank account
curl --request POST \
  --url https://api.check.et/api/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank": "cbe",
  "account_number": "1000876543218",
  "label": "Main CBE Account",
  "is_primary": true
}
'
{
  "account": {
    "id": 3,
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "account_number": "1000876543218",
    "account_last_four": "3218",
    "label": "Main CBE Account",
    "is_primary": true
  }
}

​
Required fields

FieldRequiredDescription
bankYesBank code (e.g. cbe, telebirr)
account_numberYesFull account number
labelYesFriendly name shown in the dashboard
is_primaryNoMark as the default account for this bank
Once saved, reference this account by bank_account_id in verify calls instead of repeating account_number every time.

Authorizations

​
Authorization
string
header
required

API key from your dashboard - starts with chk_. Requires a business account.

Body

application/json
​
bank
string
required
Example:

"cbe"

​
account_number
string
required
Example:

"1000876543218"

​
label
string
Example:

"Main CBE Account"

​
is_primary
boolean
Example:

true

Response

201 - application/json

Created

​
account
object