POST
/
customers
/
{customerID}
/
external_accounts
Create a new External Account
curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/external_accounts \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "currency": "usd",
  "bank_name": "<string>",
  "account_owner_name": "<string>",
  "account_number": "<string>",
  "routing_number": "<string>",
  "account_type": "us",
  "iban": {
    "account_number": "<string>",
    "bic": "<string>",
    "country": "<string>"
  },
  "account": {
    "account_number": "<string>",
    "routing_number": "<string>",
    "checking_or_savings": "checking"
  },
  "swift": {
    "account": {
      "account_number": "<string>",
      "bic": "<string>",
      "country": "<string>"
    },
    "address": {
      "street_line_1": "<string>",
      "street_line_2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    },
    "category": "<string>",
    "purpose_of_funds": [
      "<string>"
    ],
    "short_business_description": "<string>"
  },
  "clabe": {
    "account_number": "<string>"
  },
  "account_owner_type": "individual",
  "first_name": "<string>",
  "last_name": "<string>",
  "business_name": "<string>",
  "address": {
    "street_line_1": "<string>",
    "street_line_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  }
}'
{
"id": "ea_123",
"account_type": "us",
"currency": "usd",
"customer_id": "cust_123",
"account_owner_name": "John Doe",
"bank_name": "Wells Fargo",
"last_4": "1111",
"active": true,
"beneficiary_address_valid": true,
"account": {
"last_4": "1111",
"routing_number": "121000248",
"checking_or_savings": "checking"
},
"created_at": "2020-01-01T00:00:00.000Z",
"updated_at": "2020-01-02T00:00:00.000Z"
}

Authorizations

Api-Key
string
header
required

Headers

Idempotency-Key
string
required

Path Parameters

customerID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Query Parameters

limit
integer

The number of items to return (default of 10, max of 100)

starting_after
string

This is an external account id. If this is specified, the next page that starts with an external account right AFTER the specified external account id on the external account timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that external accounts older than the specified external account id will be returned (shouldn't be set if ending_before is set)

ending_before
string

This is an external account id. If this is specified, the previous page that ends with an external account right BEFORE the specified external account id on the external account timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that external accounts newer than the specified external account id will be returned (shouldn't be set if starting_after is set)

Body

application/json

New External Account object to be created

id
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
account_owner_name
string
required

Owner of the account Bank Account (e.g. "John Doe"). For ach or wire transfers, this field must be at least 3 characters, at most 35 characters, and follow either of the following regex patterns:

  • ach: ^(?!\s*$)[\x20-\x7E]*$
  • wire: ^[ \w!"#$%&'()+,\-./:;<=>?@\\_`~]*$
Required string length: 1 - 256
iban
object
required

IBAN bank account information. Required when the account_type is iban.

currency
enum<string>

Currency associated with the bank account. Default is usd. When eur is specified, the account type must be iban

Available options:
usd,
eur,
mxn
bank_name
string

Bank name of the account (e.g. "Chase")

Required string length: 1 - 256
account_number
string

Account number of your bank account. This field is getting deprecated in favor of the account.account_number field for US accounts.

Minimum length: 12
routing_number
string

Routing number of your bank account. This field is getting deprecated in favor of the account.routing_number field for US accounts.

Minimum length: 9
account_type
enum<string>

Type of the bank account. The default is us

Available options:
us,
iban,
clabe,
unknown
account
object

US bank account information. Required when the account_type is us. However, the top-level account_number and routing_number fields in deprecation will continue to be supported.

swift
object

SWIFT bank account information. Required when using SWIFT payment rails. Supported account types are iban and unknown.

clabe
object

Mexican CLABE bank account information for SPEI payment rails. Required when account type is clabe.

account_owner_type
enum<string>

The type of the account ownership. Required when the account_type is iban. For individual ownership, first_name and last_name are required. For business ownership, business_name is required.

Available options:
individual,
business
first_name
string

First name of the individual account holder. Required when the account_owner_type is individual

last_name
string

Last name of the individual account holder. Required when the account_owner_type is individual

business_name
string

Business name of the business account holder. Required when the account_owner_type is business

address
object

Address of the beneficiary of this account. Please ensure the address is valid (Google Maps is good for this). US addresses used to receive wires must include a street number.

Response

External Account object created

id
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
customer_id
string
required

The id of the Bridge customer that this External Account belongs to

Minimum length: 1
currency
enum<string>
required

Currency associated with the bank account. Default is usd. When eur is specified, the account type must be iban

Available options:
usd,
eur,
mxn
account_owner_name
string
required

Owner of the account Bank Account (e.g. "John Doe"). For ach or wire transfers, this field must be at least 3 characters, at most 35 characters, and follow either of the following regex patterns:

  • ach: ^(?!\s*$)[\x20-\x7E]*$
  • wire: ^[ \w!"#$%&'()+,\-./:;<=>?@\\_`~]*$
Required string length: 1 - 256
account_type
enum<string>
required

Type of the bank account. The default is us

Available options:
us,
iban,
clabe,
unknown
iban
object
required

IBAN bank account information. Required when the account_type is iban. IBAN bank account information. It's populated when the account_type is iban.

created_at
string<date-time>
required

Time of creation of the External Account

updated_at
string<date-time>
required

Time of last update of the External Account

active
boolean
required

Whether or not this External Account is active

bank_name
string

Bank name of the account (e.g. "Chase")

Required string length: 1 - 256
last_4
string
deprecated

Last 4 digits of the bank account number for us account type. This field is getting deprecated in favor of the account.last_4 field

Minimum length: 1
account
object

US bank account information. Required when the account_type is us. However, the top-level account_number and routing_number fields in deprecation will continue to be supported. US bank account information. It's populated when the account_type is us

swift
object

SWIFT bank account information. Required when using SWIFT payment rails. Supported account types are iban and unknown.

clabe
object

Mexican CLABE bank account information for SPEI payment rails. Required when account type is clabe. CLABE bank account information for the SPEI (Mexican) payment rail. It's populated when the account_type is clabe.

account_owner_type
enum<string>

The type of the account ownership. Required when the account_type is iban. For individual ownership, first_name and last_name are required. For business ownership, business_name is required. Type of the account ownership

Available options:
individual,
business
first_name
string

First name of the individual account holder. Required when the account_owner_type is individual First name of the individual account owner

last_name
string

Last name of the individual account holder. Required when the account_owner_type is individual Last name of the individual account owner

business_name
string

Business name of the business account holder. Required when the account_owner_type is business Business name of the business account owner

address
object

Address of the beneficiary of this account. Please ensure the address is valid (Google Maps is good for this). US addresses used to receive wires must include a street number.

beneficiary_address_valid
boolean

Whether the beneficiary address is valid. A valid beneficiary address is required for all US External Accounts