Skip to main content
POST
/
v1
/
baas
/
accounts
{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "currency": "USD",
  "country": "US"
}

{
  "id": "acc_770e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "currency": "USD",
  "country": "US",
  "account_details": {
    "account_number": "1234567890",
    "routing_number": "021000021"
  },
  "status": "ACTIVE",
  "created_at": "2026-02-01T15:00:00Z"
}
An entity must have a SUCCEEDED onboarding status before you can create a bank account.

​
Headers

​
x-idempotency-key
string
required
Unique UUID to ensure the request is processed only once.

​
Body

​
account_id
string
required
Merchant’s Yuno account ID (UUID).
​
entity_id
string
required
The entity identifier from Create Entity.
​
currency
string
required
ISO 4217 currency code (e.g., USD, GBP, AUD, EUR).
​
country
string
required
ISO 3166-1 alpha-2 country code.

​
Response

​
id
string
Account identifier.
​
entity_id
string
Associated entity.
​
currency
string
Account currency.
​
country
string
Account country.
​
account_details
object
Region-specific account identifiers. See Account identifiers by region.
​
status
string
Account status.
​
created_at
string
ISO 8601 timestamp.
{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "currency": "USD",
  "country": "US"
}

{
  "id": "acc_770e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "currency": "USD",
  "country": "US",
  "account_details": {
    "account_number": "1234567890",
    "routing_number": "021000021"
  },
  "status": "ACTIVE",
  "created_at": "2026-02-01T15:00:00Z"
}