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

> Crea una compañía en la cuenta. Requiere userApiKey.

Crea una nueva compañía asociada a la cuenta. Útil para CRM y gestión de relaciones con empresas.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="company.name" type="string" required>
  Nombre de la compañía.
</ParamField>

<ParamField body="company.domain" type="string">
  Dominio web de la compañía (opcional).
</ParamField>

<ParamField body="company.description" type="string">
  Descripción de la compañía (opcional).
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/api/v1/accounts/1/companies' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "company": {
        "name": "Acme Inc",
        "domain": "acme.com",
        "description": "Cliente enterprise"
      }
    }'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "id": 10,
    "name": "Acme Inc",
    "contacts_count": 0,
    "domain": "acme.com",
    "description": "Cliente enterprise",
    "avatar_url": null,
    "created_at": "2026-03-13T12:00:00Z",
    "updated_at": "2026-03-13T12:00:00Z",
    "contacts": []
  }
  ```
</ResponseExample>

<ResponseField name="id" type="integer" required>
  ID de la compañía creada.
</ResponseField>

<ResponseField name="name" type="string">
  Nombre de la compañía.
</ResponseField>

<ResponseField name="contacts_count" type="integer">
  Número de contactos asociados.
</ResponseField>

<ResponseField name="created_at" type="string">
  Fecha de creación en formato ISO 8601.
</ResponseField>

## Errores

* **401**: No autenticado.
* **422**: Unprocessable Entity — datos inválidos o nombre duplicado.