Skip to content
Seismic Orchestration

POST /customers/{id}/external_accounts

Creation is nested under the owning customer, same path Bridge uses.

Request (US bank)

{
  "currency": "usd",
  "bank_name": "Wells Fargo",
  "account_owner_name": "Alice Zhang",
  "account_type": "us",
  "account": {
    "account_number": "1210002481111",
    "routing_number": "121000248",
    "checking_or_savings": "checking"
  },
  "address": {
    "street_line_1": "1 Market St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94102",
    "country": "USA"
  }
}

Request (IBAN)

{
  "currency": "eur",
  "account_owner_name": "Alice Zhang",
  "account_type": "iban",
  "account": {
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX"
  }
}

Enums

FieldValues
account_typeus, iban, clabe, pix, gb, bre_b, co_bank_transfer, unknown
currencyusd, eur, mxn, brl, gbp, cop
account.checking_or_savingschecking, savings

unknown is passed through for shape parity. Use it when none of the other account types fit. The account_type returned by GET /external_accounts/{id} always uses Bridge's enum.

Response (201)

Returns the external-account object. Account details are redacted on read: only last_4 comes back.

curl -X POST "$BASE_URL/customers/cust_01HZ…/external_accounts" \
  -H "Api-Key: $SEISMIC_ORCHESTRATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "usd",
    "bank_name": "Wells Fargo",
    "account_owner_name": "Alice Zhang",
    "account_type": "us",
    "account": {
      "account_number": "1210002481111",
      "routing_number": "121000248",
      "checking_or_savings": "checking"
    },
    "address": {
      "street_line_1": "1 Market St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "USA"
    }
  }'