Conceptos

Espacio de trabajo

Tu cuenta de Crier es un espacio de trabajo: tiene un equipo (propietarios, admins y miembros), un saldo, sus claves API y sus webhooks. Una clave API actúa sobre todo el espacio de trabajo. Ver Equipo y roles y Saldo y facturación.

Perfiles

Un perfil (prf_…) es una marca o un cliente. Agrupa sus cuentas, su cola y su zona horaria. Si construyes una plataforma, crea un perfil por cliente y guarda tu propio id en externalId. Todo espacio de trabajo empieza con un perfil, «Mi marca», que se puede renombrar o borrar.

Cuentas

Una cuenta (acc_…) es una cuenta social conectada a un perfil mediante el flujo de conexión. Su status dice si puede publicar: active, o needs_reconnection cuando la red retiró el permiso y hay que volver a conectarla. GET /v1/accounts/health comprueba las cuentas contra cada red.

Publicaciones

Una publicación (pst_…) tiene un texto, imágenes o vídeos y uno o varios destinos (targets): las cuentas donde sale, cada una con su propio texto y sus opciones de red.

Estado	Qué significa
`draft`	Borrador: guardada sin fecha. También una publicación rechazada en la revisión.
`pending_approval`	Espera a que un propietario o admin la apruebe.
`scheduled`	Programada para `scheduledFor` (o para el siguiente hueco de la cola).
`publishing`	Saliendo en las redes.
`published`	Publicada en todos sus destinos.
`partial`	Publicada en unos destinos y fallida en otros. Cada destino dice su error.
`failed`	No salió en ningún destino. Se puede reintentar con `POST /v1/posts/{id}/retry`.
`cancelled`	Cancelada antes de salir.

Cada destino tiene su propio status y, cuando sale, la url de la publicación en esa red.

Ids

Todos los ids son de Crier y tienen un prefijo que dice qué son: prf_, acc_, pst_, grp_ (grupos de cuentas), cs_ (sesiones de conexión), evt_ (eventos de webhook). Los de la bandeja (cnv_, thr_, cmt_, mtn_, rev_) son opacos: úsalos tal cual, sin interpretarlos.

Fechas y zonas horarias

Las fechas van en ISO 8601. Al programar, manda la hora con su desfase (2026-10-30T09:00:00+01:00) o una hora local con timezone (Europe/Madrid). Las respuestas devuelven UTC.

Paginación

Los listados largos devuelven nextCursor. Pásalo como cursor en la siguiente petición; cuando es null, no hay más.

{
  "data": {
    "items": [],
    "nextCursor": "eyJ…"
  }
}