Skip to main content
POST
/
customers
/
external-accounts
Create a customer-bound external account for your authenticated platform.
curl --request POST \
  --url https://{publicHost}/customers/external-accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "00000000-0000-4000-8000-000000000001",
  "currency": "PHP",
  "platformAccountId": "ext_demo_customer_php_001",
  "accountInfo": {
    "accountType": "BANK_TRANSFER",
    "accountNumber": "1234567890",
    "routingNumber": "010100013",
    "accountCategory": "CHECKING",
    "bankName": "Demo Bank"
  }
}
'
{
  "id": "ext_acc_php_001",
  "status": "ACTIVE",
  "customerId": "00000000-0000-4000-8000-000000000001",
  "currency": "PHP",
  "platformAccountId": "ext_demo_customer_php_001",
  "accountInfo": {
    "accountType": "BANK_TRANSFER",
    "accountCategory": "CHECKING",
    "bankName": "Demo Bank",
    "accountNumberLast4": "7890",
    "routingNumberLast4": "0013"
  },
  "createdAt": "2026-04-05T12:00:00Z",
  "updatedAt": "2026-04-05T12:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Body

application/json

Create a customer-bound external account for an existing customer under your authenticated platform.

​
customerId
string
required

Existing BLIPS customer identifier for the customer who owns this external account. Create the customer first and then bind the external account here.

​
currency
string
required

Fiat ISO 4217 currency code.

​
platformAccountId
string
required

Stable platform-side mapping identifier/reference for this external account.

​
accountInfo
object
required

External-account details block. accountInfo.accountType is the bounded rail/type discriminator for current bank-transfer-first flows and any future account-type variants.

Response

Customer external account created.

Frozen MVP customer-bound external-account create response with safe/masked account information.

​
id
string
required

BLIPS identifier for the bound external account.

​
status
string
required

Lifecycle status of the bound external account.

​
customerId
string
required

BLIPS customer identifier for the customer who owns this external account.

​
currency
string
required

Fiat ISO 4217 currency code for the bound external account.

​
platformAccountId
string
required

Stable platform-side mapping identifier/reference for this external account.

​
accountInfo
object
required

Safe masked external-account details returned after binding.

​
createdAt
string<date-time>
required

Creation timestamp for the bound external account.

​
updatedAt
string<date-time>
required

Most recent update timestamp for the bound external account.