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

# Gestionar contactos

> Cómo crear, consultar y organizar contactos y listas en Shimli.

Los contactos en Shimli se organizan en **listas**. Cada lista puede tener campos personalizados (nombre, teléfono, email, fecha de cumpleaños, etc.).

## Crear un contacto

Para añadir un contacto a una lista existente:

```bash theme={null}
curl -X POST https://api.shimli.app/v1/contact \
  -H "Content-Type: application/json" \
  -d '{
    "token": "TOKEN_SHIMLI",
    "idList": "ID_LIST",
    "values": {
      "phone": "50499999999",
      "name": "Juan Pérez"
    }
  }'
```

<Callout type="warning">
  El campo `phone` debe seguir la estructura **código de país + número** sin el signo `+`. Ejemplo: `50499999999`.
</Callout>

## Campos personalizados

El objeto `values` acepta cualquier campo que tengas configurado en tu lista. Por ejemplo:

```json theme={null}
"values": {
  "phone": "50499999999",
  "name": "Juan Pérez",
  "email": "juan@empresa.com",
  "city": "Tegucigalpa",
  "birthday": "1990-05-15",
  "customer_type": "premium"
}
```

Los campos disponibles dependen de la configuración de cada lista. Los gestionas desde el dashboard de Shimli.

## Consultar contactos de una lista

```bash theme={null}
curl -X GET "https://api.shimli.app/v1/contact?id=ID_LIST" \
  -H "Content-Type: application/json" \
  -d '{ "token": "TOKEN_SHIMLI" }'
```

## Flujo recomendado

<Steps>
  <Step title="Crea una lista en el dashboard">
    Ve a **Contactos → Listas → Nueva lista** y define los campos que necesitas.
  </Step>

  <Step title="Añade contactos por API">
    Usa el endpoint `POST /v1/contact` para poblar la lista desde tu sistema.
  </Step>

  <Step title="Usa la lista en campañas">
    Al crear una campaña, selecciona la lista como audiencia.
  </Step>
</Steps>

## Referencia

* [Insert Contact](/api-reference/contacts/insert-contact)
* [Get Contact](/api-reference/contacts/get-contact)