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

> Crea un nuevo contacto en la cuenta.

Crea un contacto asociado a un inbox. Es obligatorio indicar al menos el inbox y recomendable nombre o email/teléfono.

## 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="inbox_id" type="number" required>
  ID del inbox al que pertenece el contacto. Ejemplo: `1`.
</ParamField>

<ParamField body="name" type="string">
  Nombre del contacto. Ejemplo: `Alice`.
</ParamField>

<ParamField body="email" type="string">
  Email del contacto. Ejemplo: `alice@acme.inc`.
</ParamField>

<ParamField body="phone_number" type="string">
  Teléfono. Ejemplo: `+123456789`.
</ParamField>

<ParamField body="identifier" type="string">
  Identificador único en un sistema externo. Ejemplo: `1234567890`.
</ParamField>

<ParamField body="blocked" type="boolean">
  Si el contacto está bloqueado. Por defecto `false`.
</ParamField>

<ParamField body="avatar_url" type="string">
  URL de avatar (JPEG/PNG). Alternativa a enviar `avatar` como binario.
</ParamField>

<ParamField body="additional_attributes" type="object">
  Objeto libre para atributos adicionales. Ej: `{"type":"customer", "age":30}`.
</ParamField>

<ParamField body="custom_attributes" type="object">
  Atributos que deben existir como definiciones de atributos personalizados en la cuenta.
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/api/v1/accounts/1/contacts' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "inbox_id": 1,
      "name": "Alice",
      "email": "alice@acme.inc",
      "phone_number": "+57300123456",
      "identifier": "cliente-001"
    }'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "id": 10,
    "name": "Alice",
    "email": "alice@acme.inc",
    "phone_number": "+57300123456",
    "identifier": "cliente-001",
    "thumbnail": null,
    "blocked": false,
    "custom_attributes": {},
    "contact_inboxes": [],
    "additional_attributes": {}
  }
  ```
</ResponseExample>

<ResponseField name="id" type="number" required>
  ID del contacto creado.
</ResponseField>

<ResponseField name="contact_inboxes" type="array">
  Inboxes asociados al contacto.
</ResponseField>

## Errores

* **400**: Bad Request — por ejemplo inbox\_id inválido o datos incompletos.
* **401**: No autenticado.