Skip to main content
POST
/
payout
/
rails
/
off-ramp
/
customers
/
{customerDbId}
/
external-accounts
Create an external account for a Bridge customer (off-ramp)
curl --request POST \
  --url http://localhost:4000/v1/payout/rails/off-ramp/customers/{customerDbId}/external-accounts \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_name": "My US Bank Account",
  "account_type": "us_bank_account",
  "account_details": {
    "type": "checking",
    "routing_number": "021000021",
    "account_number": "123456789"
  },
  "customer_id": "e3b0c442-98fc-1c14-b39f-92d1282e8b7a",
  "currency": "usd",
  "first_name": "Jane",
  "last_name": "Doe",
  "account_owner_type": "individual"
}
'

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Path Parameters

​
customerDbId
string
required

Body

application/json
​
account_name
string
required

Friendly name for the external account

Example:

"My US Bank Account"

​
account_type
string
required

Account type (e.g. 'us_bank_account', 'iban')

Example:

"us_bank_account"

​
account_details
object
required

Account-type-specific details (routing_number, account_number, etc.)

Example:
{
  "type": "checking",
  "routing_number": "021000021",
  "account_number": "123456789"
}
​
customer_id
string

Bridge customer ID (UUID) — required for CLABE/ACH endpoints

Example:

"e3b0c442-98fc-1c14-b39f-92d1282e8b7a"

​
currency
string

Bridge account currency (e.g. 'usd', 'eur')

Example:

"usd"

​
first_name
string

First name of the account owner

Example:

"Jane"

​
last_name
string

Last name of the account owner

Example:

"Doe"

​
account_owner_type
string

Account owner type ('individual' or 'business')

Example:

"individual"

Response

External account created or returned from cache