Skip to main content
POST
/
bank-accounts
Adicionar conta bancária
curl --request POST \
  --url https://api.conta.paybeehive.com.br/v1/bank-accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bankCode": "341",
  "agency": "1234",
  "accountNumber": "123456",
  "accountType": "checking",
  "holderName": "Bruce Wayne",
  "holderDocument": "12345678909",
  "accountDigit": "7"
}
'
{
  "bankCode": "341",
  "agency": "1234",
  "accountNumber": "123456",
  "accountType": "checking",
  "holderName": "Bruce Wayne",
  "holderDocument": "12345678909",
  "accountDigit": "7",
  "id": 888,
  "createdAt": "2026-01-04T12:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Basic Authorization usando SECRET_KEY como usuário e "x" como senha.

Headers

​
Idempotency-Key
string

Chave de idempotência para evitar duplicidade em retries.

Body

application/json
​
bankCode
string
required
Example:

"341"

​
agency
string
required
Example:

"1234"

​
accountNumber
string
required
Example:

"123456"

​
accountType
string
required
Example:

"checking"

​
holderName
string
required
Example:

"Bruce Wayne"

​
holderDocument
string
required
Example:

"12345678909"

​
accountDigit
string
Example:

"7"

Response

Conta bancária adicionada

​
bankCode
string
required
Example:

"341"

​
agency
string
required
Example:

"1234"

​
accountNumber
string
required
Example:

"123456"

​
accountType
string
required
Example:

"checking"

​
holderName
string
required
Example:

"Bruce Wayne"

​
holderDocument
string
required
Example:

"12345678909"

​
accountDigit
string
Example:

"7"

​
id
integer
Example:

888

​
createdAt
string
Example:

"2026-01-04T12:00:00Z"