Skip to main content
POST
/
ramp
/
customer
/
{customer_id}
/
bank-account
Create bank account (API)
curl --request POST \
  --url https://api.etherfuse.com/ramp/customer/{customer_id}/bank-account \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "account": {
    "birthCountryIsoCode": "MX",
    "birthDate": "1990-05-15",
    "clabe": "646180157000000004",
    "curp": "GALA900515MDFRPN08",
    "firstName": "Ana",
    "maternalLastName": "López",
    "paternalLastName": "García",
    "rfc": "GALA900515AB1",
    "transactionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
  },
  "bankAccountId": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "label": "Ana's SPEI account",
  "skipAutoApproval": false
}
EOF
{
  "abbrClabe": "•••• 0004",
  "bankAccountId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "compliant": true,
  "createdAt": "2026-05-01T14:30:00Z",
  "currency": "MXN",
  "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "etherfuseDepositClabe": "646180157000000004",
  "label": "Ana's SPEI account",
  "needsWork": false,
  "status": "active",
  "updatedAt": "2026-05-02T09:15:00Z"
}

Authorizations

​
Authorization
string
header
required

API key sent in the Authorization header.

Path Parameters

​
customer_id
string<uuid>
required

The customer (child org) ID. Must belong to the caller's organization or a direct child.

Body

application/json
​
account
Personal (MXN / SPEI) · object
required
​
bankAccountId
string<uuid> | null
​
label
string | null
​
skipAutoApproval
boolean

Response

The created bank account

​
abbrClabe
string
required
deprecated

Abbreviated CLABE number for the bank account.

​
bankAccountId
string<uuid>
required

Unique identifier for the bank account. Must be a valid UUID v4.

​
compliant
boolean
required

Whether the bank account is compliant. This is a derived value — true if the account has been explicitly marked compliant OR the owning organization is approved (KYB'd).

​
createdAt
string<date-time>
required

Timestamp when the bank account was created.

​
currency
string
required

Settlement currency (ISO 4217, e.g. MXN).

​
customerId
string<uuid>
required

ID of the customer who owns this bank account.

​
needsWork
boolean
required

Whether the bank account still needs work (e.g. failed verification) before it can be used for transactions.

​
status
string
required

Current status of the bank account.

​
updatedAt
string<date-time>
required

Timestamp when the bank account was last updated.

​
deletedAt
string<date-time> | null

Timestamp when the bank account was deleted (if applicable).

​
etherfuseDepositClabe
string | null

Etherfuse deposit CLABE number.

​
label
string | null

Custom label for the bank account.