> ## 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 grupo de cuentas

> Crea un nuevo grupo de cuentas para organizar comercios o unidades de negocio dentro de una organización

Crea un nuevo grupo (suborganización) dentro de tu organización. Los grupos de cuentas se pueden usar para organizar distintos comercios o unidades de negocio bajo una única entidad matriz.

Pasa `account_codes` para asociar cuentas existentes al grupo en la misma solicitud. Un grupo nuevo siempre se crea como raíz; para anidarlo bajo otro grupo, define `parent_code` con [Update Account Group](https://docs.y.uno/es/reference/organizations/update-account-group.md).


## OpenAPI

````yaml openapi/es/organizations/create-account-group.json POST /organizations/account-groups
openapi: 3.1.0
info:
  title: Account Groups 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:
    post:
      summary: Crear un grupo de cuentas
      description: Crea un nuevo grupo (suborganización).
      operationId: create-account-group
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - merchant_id
              properties:
                name:
                  type: string
                  description: Nombre del grupo de cuentas (min=1, max=255).
                merchant_id:
                  type: string
                  description: >-
                    Identificador único que el comercio usa en sus sistemas
                    (min=1, max=255).
                account_codes:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: >-
                    Opcional. Los `id` de las cuentas existentes que se
                    asociarán al nuevo grupo en la misma transacción. Una cuenta
                    pertenece a un solo grupo a la vez, por lo que una cuenta
                    que ya está en otro grupo se mueve al nuevo. Si algún código
                    no coincide con una cuenta activa de la organización, toda
                    la solicitud falla y no se crea ningún grupo. El valor
                    predeterminado es una lista vacía.
      responses:
        '201':
          description: Creado
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: El identificador único del grupo de cuentas.
                  name:
                    type: string
                  merchant_id:
                    type: string
                  parent_code:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    description: >-
                      El `id` del grupo bajo el cual se anida este grupo.
                      Siempre es `null` al crear: un grupo nuevo se crea como
                      raíz y se anida después con Update Account Group.
                  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.