Quickstart

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 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.

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.

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.

Lee algunos contactos

curl "https://api.chatsailer.com/v1/contacts?limit=5" \
  -H "Authorization: Bearer $SAILER_API_TOKEN"

{
  "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.

Crea uno

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.

Autenticación

Scopes, y los dos límites que conviene saber de antemano.

Referencia de la API

Cada endpoint, con un playground.

Primeros pasos

Trabajar con la API

Siguiente

Autenticación

Referencia de la API

​Siguiente

Autenticación

Referencia de la API

Siguiente