Skip to main content
POST
/
banking
/
accounts
Create Account (Banking Connectivity)
curl --request POST \
  --url https://api-sandbox.y.uno/v1/banking/accounts \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "onboarding_id": "onb_990e8400-e29b-41d4-a716-446655440000",
  "account_type": "CHECKING",
  "currency": "USD"
}
'
{
  "id": "acct_aa0e8400-e29b-41d4-a716-446655440000",
  "entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "onboarding_id": "onb_990e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "provider": {
    "account_id": "col_bank_account_789"
  },
  "account_type": "CHECKING",
  "status": "ACTIVE",
  "account_number": "1234567890",
  "routing_number": "123456789",
  "iban": null,
  "currency": "USD",
  "balance": {
    "available": 0,
    "current": 0,
    "pending": 0
  },
  "account_details": {
    "account_name": "John Doe - Checking",
    "sort_code": null,
    "bsb": null,
    "swift": null
  },
  "payment_rails": {
    "incoming": [
      "ACH",
      "WIRE"
    ],
    "outgoing": [
      "ACH",
      "WIRE"
    ]
  },
  "supports_book_transfers": true,
  "created_at": "2026-02-01T10:10:00Z",
  "updated_at": "2026-02-01T10:10:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

Create a bank account for an onboarded entity. The onboarding referenced by onboarding_id must have status: SUCCEEDED. The response includes region-specific banking identifiers. See Account identifiers by region for which fields are returned per region.

Authorizations

​
public-api-key
string
header
required
​
private-secret-key
string
header
required

Headers

​
x-idempotency-key
string
required

Unique identifier used in HTTP headers to ensure that a request is processed only once, even if it is retried due to network issues or timeouts. See authentication for details (UUID).

Body

application/json
​
account_id
string
required

The unique identifier of the merchant's Yuno account. Found on the Yuno dashboard (UUID, 36 characters).

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
onboarding_id
string
required

The id of a successful onboarding obtained from Create Entity Onboarding. The onboarding must have status: SUCCEEDED.

Example:

"onb_990e8400-e29b-41d4-a716-446655440000"

​
account_type
enum<string>
required

The type of bank account to create.

Available options:
CHECKING,
SAVINGS,
INVESTMENT
Example:

"CHECKING"

​
currency
string
required

The currency for the account (ISO 4217, 3 characters). Supported values depend on the provider region: USD (US), GBP (UK), AUD (Australia), EUR (EU).

Example:

"USD"

Response