Skip to main content
POST
/
payout
/
rails
/
external-accounts-ach
Create external account (ACH/USA)
curl --request POST \
  --url http://localhost:4000/v1/payout/rails/external-accounts-ach \
  --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"
}
'
{
  "success": true,
  "message": "<string>",
  "statusCode": 123,
  "timestamp": "<string>",
  "data": {
    "id": "ea_567",
    "customer_id": "cust_567",
    "account_type": "clabe",
    "currency": "mxn",
    "account_owner_name": "Juan García",
    "bank_name": "Banco Santander México",
    "active": true,
    "created_at": "2020-01-01T00:00:00.000Z",
    "updated_at": "2020-01-02T00:00:00.000Z",
    "clabe": {
      "last_4": "0007"
    },
    "account_owner_type": "individual",
    "first_name": "Juan",
    "last_name": "García",
    "account": {
      "last_4": "1111",
      "routing_number": "121000248",
      "checking_or_savings": "checking"
    }
  },
  "path": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

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

​
success
boolean
required
​
message
string
required
​
statusCode
number
required
​
timestamp
string
required
​
data
object
​
path
string