Create Account

Create a bank account for an onboarded entity

POST /v1/baas/accounts

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "currency": "USD",
  "country": "US"
}

201 Created (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"
}

201 Created (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"
}