> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Account (Platform)

> Crea una cuenta a nivel de plataforma. Requiere token platformAppApiKey.

Crea una nueva cuenta en la plataforma. Solo aplicaciones con token de plataforma pueden usar este endpoint.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de aplicación de plataforma (**platformAppApiKey**). Obtenido por el administrador tras crear una platformApp.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="name" type="string">
  Nombre de la cuenta. Ejemplo: `My Account`.
</ParamField>

<ParamField body="locale" type="string">
  Locale de la cuenta. Ejemplo: `en`.
</ParamField>

<ParamField body="domain" type="string">
  Dominio de la cuenta. Ejemplo: `example.com`.
</ParamField>

<ParamField body="support_email" type="string">
  Email de soporte. Ejemplo: `support@example.com`.
</ParamField>

<ParamField body="status" type="string">
  Estado de la cuenta: `active` o `suspended`. Por defecto `active`.
</ParamField>

<ParamField body="limits" type="object">
  Límites de la cuenta (objeto opcional).
</ParamField>

<ParamField body="custom_attributes" type="object">
  Atributos personalizados (objeto opcional).
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/platform/api/v1/accounts' \
    -H 'api_access_token: TU_PLATFORM_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "name": "Mi Cuenta",
      "locale": "es",
      "domain": "miempresa.com",
      "support_email": "soporte@miempresa.com",
      "status": "active"
    }'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "id": 42,
    "name": "Mi Cuenta"
  }
  ```
</ResponseExample>

<ResponseField name="id" type="number" required>
  ID numérico asignado a la cuenta creada.
</ResponseField>

<ResponseField name="name" type="string">
  Nombre de la cuenta.
</ResponseField>

## Errores

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Token inválido o no proporcionado. Verifica que uses **platformAppApiKey**, no userApiKey.
  </Accordion>

  <Accordion title="400 Bad Request">
    Cuerpo JSON inválido o campos requeridos faltantes.
  </Accordion>
</AccordionGroup>