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

# Quickstart

> Haz tu primera petición autenticada y lee un contacto.

<Steps>
  <Step title="Consigue un token">
    Los tokens los crea un administrador de tu workspace de Sailer — cualquiera
    con el permiso de **Configuration**. Pídele uno con el scope de lo que
    planeas construir; ver [Autenticación](/es/guides/authentication) para la
    lista de scopes.

    Un token se ve así: `sk_live_AbC123.xYz789...`. Se muestra **una sola vez**,
    al crearlo, y se guarda solo como hash — así que ponlo en un lugar seguro.
    Un token perdido no se puede recuperar, solo reemplazar.
  </Step>

  <Step title="Confirma que funciona">
    `GET /v1/me` describe el token mismo. Es la forma más barata de comprobar
    que la autenticación está bien conectada.

    ```bash theme={null}
    curl https://api.chatsailer.com/v1/me \
      -H "Authorization: Bearer $SAILER_API_TOKEN"
    ```

    La respuesta te dice a qué workspace pertenece el token y qué scopes
    lleva. No hay header de tenant que configurar: el workspace lo implica el
    token.
  </Step>

  <Step title="Lee algunos contactos">
    ```bash theme={null}
    curl "https://api.chatsailer.com/v1/contacts?limit=5" \
      -H "Authorization: Bearer $SAILER_API_TOKEN"
    ```

    ```json theme={null}
    {
      "data": [
        {
          "object": "contact",
          "id": "con_...",
          "first_name": "Ana",
          "last_name": "Ribeiro",
          "email": "ana@example.com",
          "phone": "+5511999999999",
          "status": "active",
          "custom_fields": { "segment": "enterprise", "annual_revenue": null },
          "created_at": "2026-08-14T12:04:11Z",
          "updated_at": "2026-08-29T09:31:52Z"
        }
      ],
      "meta": { "limit": 5, "has_more": true },
      "links": { "next": "https://api.chatsailer.com/v1/contacts?limit=5&cursor=..." }
    }
    ```

    Sigue `links.next` para paginar el resto. Ver
    [Paginación](/es/guides/pagination).
  </Step>

  <Step title="Crea uno">
    ```bash theme={null}
    curl -X POST https://api.chatsailer.com/v1/contacts \
      -H "Authorization: Bearer $SAILER_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"first_name": "Bruno", "phone": "+5511987654321", "email": "bruno@example.com"}'
    ```

    Esto necesita el scope `contacts:write`. `first_name` y `phone` son
    required; el phone es único por workspace y se guarda como E.164. Si tu
    token no tiene el scope, recibes un 403 que nombra exactamente lo que
    falta — ver [Errores](/es/guides/errors).
  </Step>
</Steps>

## Siguiente

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/es/guides/authentication">
    Scopes, y los dos límites que conviene saber de antemano.
  </Card>

  <Card title="Referencia de la API" icon="code" href="/api-reference">
    Cada endpoint, con un playground.
  </Card>
</CardGroup>