> ## 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.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Crear cuenta

> Crea una cuenta bancaria para una entidad cuyo estado de onboarding fue exitoso

Crea una cuenta bancaria para una entidad con onboarding completado. El onboarding referenciado por `onboarding_id` debe tener `status: SUCCEEDED`. Un onboarding de tipo `PREVIOUSLY_ONBOARDED` no puede crear una cuenta hoy: la API responde `500` con `PROVIDER_ACCOUNT_CREATION_FAILED`.

La respuesta incluye identificadores bancarios específicos de cada región. Consulta [Identificadores de cuenta por región](https://docs.y.uno/es/reference/banking-connectivity.md#account-identifiers-by-region) para saber qué campos se devuelven por región.


## OpenAPI

````yaml openapi/es/banking-connectivity/accounts/create-account-banking.json POST /banking/accounts
openapi: 3.0.0
info:
  version: 1.0.0
  title: Banking Connectivity
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - public-api-key: []
    private-secret-key: []
paths:
  /banking/accounts:
    post:
      tags:
        - Accounts (Banking Connectivity)
      summary: Crear cuenta (Banking Connectivity)
      description: >-
        Crea una cuenta bancaria para una entidad incorporada. Un onboarding de
        tipo PREVIOUSLY_ONBOARDED no puede crear una cuenta hoy: la API responde
        500 PROVIDER_ACCOUNT_CREATION_FAILED.
      operationId: post_v1-banking-connectivity-accounts
      parameters:
        - in: header
          name: x-idempotency-key
          schema:
            type: string
          description: >-
            Identificador único que se usa en los encabezados HTTP para asegurar
            que una solicitud se procese una sola vez, aunque se reintente por
            problemas de red o tiempos de espera agotados. Consulta
            [autenticación](/es/reference/getting-started/authentication#idempotency)
            para ver los detalles (UUID).
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - entity_id
                - onboarding_id
                - connection_id
                - account_type
                - country
                - currency
              properties:
                account_id:
                  type: string
                  description: >-
                    El identificador único de la cuenta de Yuno del comercio. Lo
                    encuentras en el [Dashboard de
                    Yuno](https://dashboard.y.uno/) (UUID, 36 caracteres).
                  example: 550e8400-e29b-41d4-a716-446655440000
                entity_id:
                  type: string
                  description: >-
                    El `id` de la entidad propietaria de la cuenta, que se
                    obtiene de [Create
                    Entity](/es/reference/banking-connectivity/entities-banking-connectivity/create-entity)
                    (UUID, 36 caracteres).
                  example: 660e8400-e29b-41d4-a716-446655440000
                onboarding_id:
                  type: string
                  description: >-
                    El `id` de un onboarding exitoso, que se obtiene de [Create
                    Entity
                    Onboarding](/es/reference/banking-connectivity/entity-onboarding-banking-connectivity/create-entity-onboarding)
                    (UUID, 36 caracteres). El onboarding debe tener `status:
                    SUCCEEDED`.
                  example: 990e8400-e29b-41d4-a716-446655440000
                connection_id:
                  type: string
                  description: >-
                    El `id` de la conexión con el proveedor bancario en la que
                    se abrirá la cuenta (UUID, 36 caracteres).
                  example: bb0e8400-e29b-41d4-a716-446655440000
                account_type:
                  type: string
                  description: El tipo de cuenta bancaria que se creará.
                  enum:
                    - CHECKING
                    - SAVINGS
                    - INVESTMENT
                  example: CHECKING
                currency:
                  type: string
                  description: >-
                    La moneda de la cuenta ([ISO
                    4217](https://en.wikipedia.org/wiki/ISO_4217), 3
                    caracteres). Los valores admitidos dependen de la región del
                    proveedor: `USD` (EE. UU.), `GBP` (Reino Unido), `AUD`
                    (Australia), `EUR` (UE).
                  example: USD
                country:
                  type: string
                  description: >-
                    El país de la cuenta ([ISO 3166-1
                    alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2),
                    2 caracteres).
                  example: US
            examples:
              Create Account:
                summary: Create Account
                value:
                  account_id: 550e8400-e29b-41d4-a716-446655440000
                  entity_id: 660e8400-e29b-41d4-a716-446655440000
                  onboarding_id: 990e8400-e29b-41d4-a716-446655440000
                  connection_id: bb0e8400-e29b-41d4-a716-446655440000
                  account_type: CHECKING
                  country: US
                  currency: USD
      responses:
        '200':
          description: ''
        '201':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: >-
                      El identificador único de la cuenta de Banking
                      Connectivity (UUID, 36 caracteres).
                    example: aa0e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    description: El `id` de la entidad asociada a esta cuenta.
                    example: 660e8400-e29b-41d4-a716-446655440000
                  onboarding_id:
                    type: string
                    description: El `id` del onboarding usado para crear esta cuenta.
                    example: 990e8400-e29b-41d4-a716-446655440000
                  account_id:
                    type: string
                    description: El identificador de la cuenta de Yuno del comercio.
                    example: 550e8400-e29b-41d4-a716-446655440000
                  provider:
                    type: object
                    description: Identificadores de la cuenta del lado del proveedor.
                    properties:
                      account_id:
                        type: string
                        description: El identificador interno de la cuenta del proveedor.
                        example: col_bank_account_789
                  account_type:
                    type: string
                    description: El tipo de cuenta bancaria.
                    enum:
                      - CHECKING
                      - SAVINGS
                      - INVESTMENT
                    example: CHECKING
                  status:
                    type: string
                    description: El estado actual de la cuenta.
                    enum:
                      - ACTIVE
                      - PENDING
                      - INACTIVE
                    example: ACTIVE
                  account_number:
                    type: string
                    description: El número de la cuenta bancaria.
                    example: '1234567890'
                  routing_number:
                    type: string
                    nullable: true
                    description: >-
                      El número de ruta (routing number) de EE. UU. Está
                      presente en cuentas de EE. UU.
                    example: '123456789'
                  iban:
                    type: string
                    nullable: true
                    description: >-
                      El número de cuenta bancaria internacional (IBAN). Está
                      presente en cuentas del Reino Unido y la UE.
                    example: null
                  currency:
                    type: string
                    description: >-
                      La moneda de la cuenta ([ISO
                      4217](https://en.wikipedia.org/wiki/ISO_4217)).
                    example: USD
                  balance:
                    type: object
                    description: La información del saldo actual de la cuenta.
                    properties:
                      available:
                        type: number
                        description: >-
                          El saldo disponible que se puede usar para
                          transferencias.
                        example: 0
                      current:
                        type: number
                        description: >-
                          El saldo total actual, incluidas las transacciones
                          pendientes.
                        example: 0
                      pending:
                        type: number
                        description: >-
                          El monto que está actualmente en transacciones
                          pendientes.
                        example: 0
                  account_details:
                    type: object
                    description: >-
                      Detalles adicionales de la cuenta e identificadores
                      específicos de cada región.
                    properties:
                      account_name:
                        type: string
                        description: El nombre para mostrar de la cuenta.
                        example: John Doe - Checking
                      sort_code:
                        type: string
                        nullable: true
                        description: >-
                          El sort code del Reino Unido. Está presente en cuentas
                          del Reino Unido.
                        example: null
                      bsb:
                        type: string
                        nullable: true
                        description: >-
                          El número BSB de Australia. Está presente en cuentas
                          de Australia.
                        example: null
                      swift:
                        type: string
                        nullable: true
                        description: >-
                          El código SWIFT/BIC para transferencias
                          internacionales.
                        example: null
                  payment_rails:
                    type: object
                    description: Los rieles de pago que admite esta cuenta.
                    properties:
                      incoming:
                        type: array
                        description: Rieles de pago disponibles para recibir fondos.
                        items:
                          type: string
                        example:
                          - ACH_STANDARD
                          - WIRE
                      outgoing:
                        type: array
                        description: Rieles de pago disponibles para enviar fondos.
                        items:
                          type: string
                        example:
                          - ACH_STANDARD
                          - WIRE
                  supports_book_transfers:
                    type: boolean
                    description: >-
                      Indica si la cuenta admite transferencias internas (book)
                      entre cuentas del mismo proveedor.
                    example: true
                  created_at:
                    type: string
                    description: >-
                      La marca de tiempo del momento en que se creó la cuenta
                      (ISO 8601).
                    example: '2026-02-01T10:10:00Z'
                  updated_at:
                    type: string
                    description: >-
                      La marca de tiempo de la última actualización de la cuenta
                      (ISO 8601).
                    example: '2026-02-01T10:10:00Z'
              examples:
                Created (Account):
                  summary: Created (Account)
                  value:
                    id: aa0e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    onboarding_id: 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_STANDARD
                        - WIRE
                      outgoing:
                        - ACH_STANDARD
                        - WIRE
                    supports_book_transfers: true
                    created_at: '2026-02-01T10:10:00Z'
                    updated_at: '2026-02-01T10:10:00Z'
          description: Creado
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                      example: Onboarding status must be SUCCEEDED to create an account
                  http_code:
                    type: integer
                    example: 400
                    default: 0
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: VALIDATION_ERROR
                    messages:
                      - Onboarding status must be SUCCEEDED to create an account
                    http_code: 400
          description: Solicitud incorrecta
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ONBOARDING_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Onboarding not found
                  http_code:
                    type: integer
                    example: 404
                    default: 0
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: ONBOARDING_NOT_FOUND
                    messages:
                      - Onboarding not found
                    http_code: 404
          description: No encontrado
components:
  securitySchemes:
    public-api-key:
      type: apiKey
      in: header
      name: public-api-key
    private-secret-key:
      type: apiKey
      in: header
      name: private-secret-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.