Skip to main content
POST
/
api
/
payments
/
v3
/
bank-accounts
Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method. 
curl --request POST \
  --url http://localhost/api/payments/v3/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "accountNumber": "<string>",
  "iban": "<string>",
  "swiftBicCode": "<string>",
  "country": "<string>",
  "metadata": {}
}'
{
  "data": "<string>"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
name
string
required
​
accountNumber
string
​
iban
string
​
swiftBicCode
string
​
country
string
​
metadata
object | null

Response

Created

​
data
string
required

The ID of the created bank account

⌘I