Reclee

Notificaciones

Las notificaciones de la persona dueña de la key, su estado de lectura y sus preferencias de aviso.

Las notificaciones son los avisos que Reclee le manda a una persona: una longlist que cerró o se pausó, una vacante que le asignaron, un candidato del sourcing que se postuló, alguien nuevo en el equipo. Son personales: con una API key lees y marcas las notificaciones de la persona dueña de la key, nunca las de otro miembro.

Una notificación vence a los 30 días: la lista y el contador solo cuentan las de los últimos 30 días. Además de leerlas, puedes marcarlas como leídas o no leídas y cambiar qué avisos recibe la persona, en la app (IN_APP) y por email (EMAIL).

Lista

GET /notifications

GET/notifications

Devuelve las notificaciones de los últimos 30 días, de la más nueva a la más vieja, como un array. No usa la paginación estándar: trae hasta limit filas (como máximo 200), y el header X-Has-More: true avisa que había más de las que vinieron.

CampoTipoRequeridoDescripción
unreadOnlybooleanOpcionaltrue trae solo las no leídas.
typeenumOpcionalSolo un tipo de notificación (ver la tabla de abajo).
jobPostIduuidOpcionalSolo las de esa vacante.
limitintegerOpcionalCuántas traer, de 1 a 200. Default 200.

Un parámetro desconocido contesta 400 INVALID.

curl -i "https://app.reclee.com/api/v1/notifications?unreadOnly=true&limit=20" \
  -H "Authorization: Bearer rcl_..."

Respuesta (extracto, dos notificaciones):

[
  {
    "id": "6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "createdAt": "2026-10-21T18:42:10.000Z",
    "readAt": null,
    "count": 1,
    "day": "2026-10-21",
    "daysAgo": 1,
    "jobPostId": "c2e4f6a8-1b3d-4f5a-9c7e-2d4f6a8b0c1e",
    "type": "LONGLIST_CLOSED",
    "longlistId": "8f9e0d1c-2b3a-4c5d-9e8f-7a6b5c4d3e2f",
    "jobPostTitle": "Backend Developer Sr.",
    "profileCount": 48,
    "closeReason": "PROFILE_CAP",
    "closedBy": null
  },
  {
    "id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
    "createdAt": "2026-10-20T11:05:00.000Z",
    "readAt": null,
    "count": 3,
    "day": "2026-10-20",
    "daysAgo": 2,
    "jobPostId": "c2e4f6a8-1b3d-4f5a-9c7e-2d4f6a8b0c1e",
    "type": "NEW_APPLICATION_RECEIVED",
    "jobPostTitle": "Backend Developer Sr."
  }
]

Todas las notificaciones traen id, createdAt, readAt (null si no está leída), count (cuántos avisos iguales agrupa), day (el día del calendario del workspace), daysAgo (0 es hoy) y jobPostId (null si no es de una vacante o ya no se puede ver). El resto de los campos depende de type; cualquier sujeto que se haya borrado llega como null:

typeCampos propios
LONGLIST_CLOSEDlonglistId, jobPostTitle, profileCount, closeReason, closedBy ({ name, initials } o null si cerró sola)
LONGLIST_PAUSEDlonglistId, jobPostTitle, profileCount, pauseReason (PROFILE_CAP, LOW_PERFORMANCE o DROUGHT)
SOURCING_FAILEDlonglistId, jobPostTitle, failure
JOB_POST_ASSIGNEDjobPostTitle, actor, pipelineCount, openDays
SOURCED_CANDIDATE_APPLIEDcandidate, profileId, jobPostTitle, fit
NEW_APPLICATION_RECEIVEDjobPostTitle
SHORTLIST_VIEWEDjobPostTitle, shortlistStageId
OPEN_APPLICATION_RECEIVED(ninguno)
APPLICATION_WITHDRAWNcandidate, profileId, jobPostTitle, stage ({ name, templateKey })
MEMBER_JOINEDmember, emailDomain
OWNERSHIP_TRANSFERREDgiver, giverStays (el rol con el que quedó quien transfirió, u OUT si se fue)
CV_IMPORT_FINISHEDcvImportJobId, created, existing, failed
MATCH_SCORES_RECALCULATEDjobPostTitle, tally ({ scored, skipped, failed, remaining })

MATCH_SCORE_MOVED sigue existiendo como valor de type en notificaciones viejas (con jobPostTitle), pero ya no se genera.

GET /notifications/unread-count

GET/notifications/unread-count

Devuelve cuántas notificaciones no leídas de los últimos 30 días tiene la persona.

curl https://app.reclee.com/api/v1/notifications/unread-count \
  -H "Authorization: Bearer rcl_..."

Respuesta:

{ "count": 4 }

Estado de lectura

POST /notifications/read

POST/notifications/read

Marca como leídas las notificaciones que le pases. Devuelve en moved cuántas cambiaron de verdad: una que ya estaba leída, que no es tuya o que no existe no cuenta, y no es un error.

CampoTipoRequeridoDescripción
idsuuid[]SíLos id de las notificaciones, hasta 200.
curl -X POST https://app.reclee.com/api/v1/notifications/read \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "ids": ["6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d"] }'

Respuesta:

{ "moved": 1 }

POST /notifications/read-all

POST/notifications/read-all

Marca como leídas todas las notificaciones no leídas de la persona. No lleva body. Devuelve cuántas cambiaron.

curl -X POST https://app.reclee.com/api/v1/notifications/read-all \
  -H "Authorization: Bearer rcl_..."

Respuesta:

{ "moved": 4 }

DELETE /notifications/{notificationId}/read

DELETE/notifications/{notificationId}/read

Vuelve a marcar una notificación como no leída: borra la marca de lectura, no la notificación. Contesta 204 sin body si cambió, y 404 NOT_FOUND si no había nada que cambiar (la notificación no es tuya, no existe o ya estaba sin leer).

CampoTipoRequeridoDescripción
notificationIduuidSíEl id de la notificación (path).
curl -X DELETE https://app.reclee.com/api/v1/notifications/6a1d2b3c-4e5f-4a6b-8c7d-9e0f1a2b3c4d/read \
  -H "Authorization: Bearer rcl_..."

Preferencias

GET /notifications/preferences

GET/notifications/preferences

Devuelve, para cada tipo de notificación, si la persona la recibe en la app (inApp) y por email (email). Las preferencias son de la persona, no del workspace: valen en todos los workspaces de los que es miembro.

Por defecto todo llega a la app. Por email llegan de entrada LONGLIST_CLOSED, LONGLIST_PAUSED, SOURCING_FAILED, JOB_POST_ASSIGNED y OWNERSHIP_TRANSFERRED; los demás tipos llegan por email solo si la persona lo activa.

curl https://app.reclee.com/api/v1/notifications/preferences \
  -H "Authorization: Bearer rcl_..."

Respuesta (extracto):

[
  { "type": "LONGLIST_CLOSED", "inApp": true, "email": true },
  { "type": "NEW_APPLICATION_RECEIVED", "inApp": true, "email": false },
  { "type": "MEMBER_JOINED", "inApp": false, "email": false }
]

PATCH /notifications/preferences

PATCH/notifications/preferences

Prende o apaga avisos, de a varios. Solo cambia los pares tipo-canal que mandas; el resto queda como estaba. Devuelve la lista completa de preferencias, con la forma de GET /notifications/preferences. Repetir el mismo cambio no hace nada, así que reintentar es seguro.

CampoTipoRequeridoDescripción
changesobject[]SíAl menos un cambio. Cada par type + channel puede aparecer una sola vez.
changes[].typeenumSíEl tipo de notificación (cualquiera de la tabla de arriba salvo MATCH_SCORE_MOVED).
changes[].channelenumSíIN_APP o EMAIL.
changes[].enabledbooleanSítrue la prende, false la apaga.
curl -X PATCH https://app.reclee.com/api/v1/notifications/preferences \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "changes": [
      { "type": "NEW_APPLICATION_RECEIVED", "channel": "EMAIL", "enabled": true },
      { "type": "MEMBER_JOINED", "channel": "IN_APP", "enabled": false }
    ]
  }'

Si un cambio de la tanda falla a mitad de camino, los anteriores pueden haber quedado guardados: ante un 500, vuelve a leer las preferencias antes de reintentar.

En esta página