> ## 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 nueva cuenta de comercio dentro de un grupo de cuentas específico de la organización

Crea una nueva cuenta dentro de un grupo de cuentas específico. Cada cuenta representa un entorno de comercio o una unidad de negocio distinta dentro del grupo.


## OpenAPI

````yaml openapi/es/organizations/create-account.json POST /organizations/account-groups/{account_group_id}/accounts
openapi: 3.1.0
info:
  title: Accounts API - Create
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /organizations/account-groups/{account_group_id}/accounts:
    post:
      summary: Crear una cuenta
      description: Crea una cuenta nueva bajo un account_group_id.
      operationId: create-account
      parameters:
        - name: account_group_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: El identificador único del grupo de cuentas.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  description: Nombre de la cuenta (min=1, max=255).
      responses:
        '201':
          description: Creado
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
                  account_group_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - ACTIVE
                      - SUSPENDED
                    readOnly: true
                    description: >-
                      Solo lectura. `SUSPENDED` mientras la cuenta está
                      suspendida, `ACTIVE` en caso contrario.
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````

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