CRM
Empresas del embudo comercial, sus personas, su actividad, los pedidos de búsqueda y sus contrataciones.
El CRM es el lado comercial de Reclee: las empresas que tu agencia trabaja (en la API, leads), las personas de cada empresa (contacts), la actividad que se registra con ellas, los pedidos de búsqueda que firman (requests) y las contrataciones que salen de esos pedidos (placements). Todas las rutas de esta página cuelgan de /crm.
Una empresa entra al embudo una sola vez y avanza por sus etapas: las tres primeras (PROSPECTING, QUALIFIED, MEETING) se mueven a mano y la de cliente (CLIENT) la pone el sistema cuando arranca su primer pedido. Nada del CRM se borra con una API key: las empresas, personas y pedidos se archivan y se pueden restaurar (ver Borrados). Para escribir también tienes las acciones de la familia CRM en Acciones · CRM, que hacen lo mismo con el mismo ejecutor que el MCP.
Permisos
Leer el CRM lo puede hacer cualquier key. Toda escritura exige un rol que pueda escribir; como una API key solo la tiene un miembro con asiento (OWNER o RECRUITER), en la práctica una key válida escribe en todo el CRM. Una escritura sin permiso contesta 403 FORBIDDEN.
Etapas
GET /crm/stages
/crm/stagesDevuelve las etapas del embudo del workspace, ordenadas por position. No pagina. Usa el id de una etapa para filtrar GET /crm/leads o para mover una empresa con PUT /crm/leads/{leadId}/stage.
Una etapa que viene con el workspace trae key (y label: null); una creada por alguien trae label y key: null. outcome dice qué significa la etapa (OPEN, WON, LOST) aunque la renombren.
curl https://app.reclee.com/api/v1/crm/stages \
-H "Authorization: Bearer rcl_..."Respuesta (extracto):
[
{
"id": "0b6e2f4a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
"key": "PROSPECTING",
"label": null,
"color": "#94a3b8",
"position": 1,
"commercial": true,
"outcome": "OPEN",
"isLocked": true
},
{
"id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"key": "CLIENT",
"label": null,
"color": "#34d399",
"position": 4,
"commercial": true,
"outcome": "WON",
"isLocked": true
}
]Empresas
GET /crm/leads
/crm/leadsLista las empresas del embudo, de la más nueva a la más vieja, con los totales del tablero (pedidos abiertos, pipeline estimado, facturado). Pagina: ver Paginación.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| stageId | uuid | Opcional | Solo las empresas en esa etapa (ver GET /crm/stages). |
| source | enum | Opcional | Origen: COLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER. |
| search | string | Opcional | Coincidencia parcial en el nombre, sin distinguir mayúsculas ni acentos. |
| archived | boolean | Opcional | true lista SOLO las archivadas. Si no se manda, las archivadas no aparecen. |
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Un parámetro desconocido (por ejemplo ?archivado=true) contesta 400 INVALID en vez de ignorarse.
curl "https://app.reclee.com/api/v1/crm/leads?search=acme&pageSize=20" \
-H "Authorization: Bearer rcl_..."Respuesta (extracto, una fila):
{
"rows": [
{
"id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12",
"name": "Acme Logística",
"website": "https://acmelogistica.example",
"linkedinUrl": "https://www.linkedin.com/company/acme-logistica-example",
"description": null,
"industry": "TRANSPORTATION_LOGISTICS",
"headcountRange": "51-200",
"country": "Argentina",
"timezone": "America/Argentina/Buenos_Aires",
"contentLocale": "es",
"stageId": "0b6e2f4a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
"stage": { "id": "0b6e2f4a-1c3d-4e5f-8a9b-0c1d2e3f4a5b", "key": "PROSPECTING", "label": null, "color": "#94a3b8", "position": 1, "commercial": true, "outcome": "OPEN", "isLocked": true },
"stageChangedAt": "2026-10-02T14:11:09.000Z",
"archivedAt": null,
"source": "REFERRAL",
"sourceDetail": null,
"defaultFeeType": "PERCENTAGE",
"defaultFeePct": 20,
"defaultFeeAmount": null,
"defaultCurrencyCode": "USD",
"defaultGuaranteeDays": 90,
"inboundRole": null,
"inboundDetails": null,
"doNotContactAt": null,
"doNotContactNote": null,
"doNotContactByName": null,
"createdAt": "2026-10-02T14:11:09.000Z",
"updatedAt": null,
"openRequests": 1,
"pipelineByCurrency": [{ "currencyCode": "USD", "min": 9000, "max": 12000 }],
"primaryContactName": "Lucía Ferreyra",
"lastActivityAt": "2026-10-15T16:00:00.000Z",
"billedByCurrency": [],
"pendingByCurrency": [],
"placementsCount": 0,
"clientStatus": null
}
],
"total": 1,
"page": 1,
"pageSize": 20
}Los montos se suman por moneda, nunca entre monedas. clientStatus (ACTIVE, IN_CONVERSATION, INACTIVE) solo viene en una empresa que ya es cliente.
POST /crm/leads
/crm/leadsCrea una empresa en el embudo y, si envías primaryPerson, también su persona principal. Devuelve la empresa creada (sin los totales del tablero). Acepta Idempotency-Key. Equivale a la acción create_lead.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre de la empresa, 1 a 200 caracteres. |
| website | url | null | Opcional | Sitio web. Se usa también para detectar duplicados. |
| linkedinUrl | url | null | Opcional | URL de LinkedIn (tiene que ser de linkedin.com). |
| description | string | null | Opcional | Hasta 5000 caracteres. |
| industry | enum | null | Opcional | TECHNOLOGY_MEDIA, FINANCIAL_SERVICES, PROFESSIONAL_SERVICES, HEALTHCARE, EDUCATION, RETAIL, WHOLESALE, MANUFACTURING, CONSTRUCTION, REAL_ESTATE, TRANSPORTATION_LOGISTICS, UTILITIES, OIL_GAS_MINING, FARMING_FORESTRY, HOSPITALITY, ENTERTAINMENT, CONSUMER_SERVICES, ADMINISTRATIVE_SERVICES, GOVERNMENT, HOLDING_COMPANIES. |
| headcountRange | string | null | Opcional | Tamaño, texto libre de hasta 60 caracteres (p. ej. 51-200). |
| country | string | null | Opcional | Hasta 120 caracteres. |
| timezone | string | null | Opcional | Hasta 60 caracteres (p. ej. America/Mexico_City). |
| contentLocale | es | en | null | Opcional | Idioma en que se le escribe a este cliente. null usa el del workspace. |
| source | enum | Opcional | COLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER. Default OTHER. |
| sourceDetail | string | null | Opcional | Detalle del origen, hasta 200 caracteres. |
| stageId | uuid | null | Opcional | Etapa inicial. Solo PROSPECTING, QUALIFIED o MEETING. Si no se manda, PROSPECTING. |
| defaultFeeType | enum | Opcional | PERCENTAGE, FIXED o MIXED. Default PERCENTAGE. |
| defaultFeePct | number | null | Opcional | 0 a 100. Con PERCENTAGE se puede omitir: toma el del workspace. Obligatorio con MIXED; prohibido con FIXED. |
| defaultFeeAmount | number | null | Opcional | Monto fijo, mayor que 0. Obligatorio con FIXED y MIXED; prohibido con PERCENTAGE. |
| defaultCurrencyCode | string | null | Opcional | Código de 3 letras (USD, ARS, MXN...). |
| defaultGuaranteeDays | integer | null | Opcional | Días de garantía de cada contratación, 1 a 365. Si no se manda, el del workspace. |
| primaryPerson | object | null | Opcional | Persona principal: firstName (obligatorio, hasta 120), lastName (hasta 120), title (hasta 160), email. |
curl -X POST https://app.reclee.com/api/v1/crm/leads \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6a1f0c2e-lead-acme" \
-d '{
"name": "Acme Logística",
"website": "https://acmelogistica.example",
"source": "REFERRAL",
"industry": "TRANSPORTATION_LOGISTICS",
"primaryPerson": { "firstName": "Lucía", "lastName": "Ferreyra", "email": "lucia@acmelogistica.example" }
}'La respuesta es el objeto empresa con los mismos campos que una fila de GET /crm/leads, sin los totales (openRequests, pipelineByCurrency, etc.).
Errores específicos:
-
409 LEAD_EXISTS: ya hay una empresa con ese nombre o ese sitio web. No se crea nada y la respuesta trae la existente, para que la abras:{ "error": "LEAD_EXISTS", "existing": { "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12", "name": "Acme Logística" } } -
409 STAGE_NOT_MANUAL:stageIdno es una de las tres etapas manuales. -
400 INVALID: el fee no tiene las partes que pide su tipo (detailsdiceFEE_PCT_REQUIRED,FEE_AMOUNT_REQUIRED,FEE_PCT_NOT_ALLOWEDoFEE_AMOUNT_NOT_ALLOWED).
El alta es todo o nada: si la persona principal no se puede crear, la empresa tampoco queda creada y la respuesta es el error de la persona.
GET /crm/leads/{leadId}
/crm/leads/{leadId}Devuelve una empresa con los totales del tablero, con la misma forma que una fila de GET /crm/leads. También alcanza a una empresa archivada.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa. |
curl https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12 \
-H "Authorization: Bearer rcl_..."Error: 404 NOT_FOUND si no existe en el workspace.
PATCH /crm/leads/{leadId}
/crm/leads/{leadId}Edita los datos de una empresa. Envía solo los campos que cambian; los que no envías quedan como están. Devuelve la empresa actualizada (sin totales). Equivale a la acción update_lead.
Acepta los mismos campos que el alta (name, website, linkedinUrl, description, industry, headcountRange, country, timezone, contentLocale, source, sourceDetail, defaultFeeType, defaultFeePct, defaultFeeAmount, defaultCurrencyCode, defaultGuaranteeDays), todos opcionales y sin defaults. No acepta stageId (la etapa tiene su propia ruta) ni primaryPerson.
Si cambias el fee, envía el tipo con sus partes: defaultFeeType junto con defaultFeePct y/o defaultFeeAmount según corresponda.
curl -X PATCH https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12 \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "defaultFeeType": "PERCENTAGE", "defaultFeePct": 18, "country": "Uruguay" }'Errores: 400 INVALID con un body vacío o un fee incompleto; 404 NOT_FOUND.
DELETE /crm/leads/{leadId}
/crm/leads/{leadId}Una API key no borra empresas. Esta ruta contesta siempre 405 DELETE_NOT_ALLOWED con la acción que la reemplaza:
{ "error": "DELETE_NOT_ALLOWED", "allowed": ["GET", "PATCH"], "suggestions": [{ "tool": "archive_lead" }] }Para sacar una empresa del embudo, archívala con PUT /crm/leads/{leadId}/archive o con la acción archive_lead.
PUT /crm/leads/{leadId}/archive
/crm/leads/{leadId}/archiveArchiva o restaura una empresa. Archivarla la saca de las listas sin borrar nada, y archiva junto con ella sus pedidos abiertos; restaurarla vuelve a traer esos pedidos. Devuelve la empresa (sin totales). Archivar equivale a la acción archive_lead.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa (en el path). |
| archived | boolean | Sí | true archiva, false restaura. |
curl -X PUT https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/archive \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "archived": true }'Error: 404 NOT_FOUND si no existe, o si ya estaba en el estado pedido (archivar una archivada o restaurar una activa).
PUT /crm/leads/{leadId}/stage
/crm/leads/{leadId}/stageMueve una empresa de etapa. El embudo solo avanza, y solo por las tres etapas manuales (PROSPECTING, QUALIFIED, MEETING): a cliente se llega cuando arranca el primer pedido. Devuelve la empresa (sin totales). Equivale a la acción move_lead_stage.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa (en el path). |
| stageId | uuid | Sí | Etapa destino (ver GET /crm/stages). |
curl -X PUT https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/stage \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "stageId": "8e2a4c6b-0d1f-4a3b-9c5d-7e6f8a9b0c1d" }'Errores:
409 CLIENT_IS_DERIVED: la etapa destino no es manual (por ejemplo, la de cliente).409 STAGE_ONLY_ADVANCES: la etapa destino está antes que la actual.400 INVALID: la empresa ya está en esa etapa.404 NOT_FOUND: no existe la empresa o la etapa.
PUT /crm/leads/{leadId}/do-not-contact
/crm/leads/{leadId}/do-not-contactMarca la empresa como «no contactar»: una señal comercial de que no se la sigue trabajando. La nota es obligatoria. Solo marca: levantar la marca se hace desde la app. Devuelve la empresa con doNotContactAt, doNotContactNote y doNotContactByName completos. Equivale a la acción set_lead_do_not_contact.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa (en el path). |
| note | string | Sí | Motivo, 1 a 500 caracteres. |
curl -X PUT https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/do-not-contact \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "note": "Pidieron no recibir más propuestas este año." }'POST /crm/leads/intake
/crm/leads/intakeRegistra una consulta entrante (por ejemplo, el formulario de contacto de tu sitio): busca a la persona por email y, si no existe, crea o reutiliza la empresa y crea a la persona; en los dos casos deja la consulta en la actividad de la empresa. No crea un pedido. Acepta Idempotency-Key.
Llámala desde tu servidor, nunca desde el navegador: la API key no tiene que quedar expuesta.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| role | string | Sí | Qué puesto buscan, 1 a 200 caracteres. |
| name | string | Sí | Nombre de quien consulta, 1 a 240 caracteres. |
| Sí | Email de quien consulta. Identifica a la persona. | ||
| phone | string | null | Opcional | Hasta 40 caracteres. |
| company | string | null | Opcional | Nombre de la empresa, hasta 200 caracteres. Se busca una existente por nombre. |
| details | string | null | Opcional | Detalle de la consulta, hasta 5000 caracteres. |
| channel | FORM | CALL | Opcional | Por dónde llegó. Default FORM. |
| bookedAt | datetime | null | Opcional | Solo con CALL: fecha y hora de la reunión agendada, ISO 8601 con zona. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/intake \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"role": "Gerente de operaciones",
"name": "Martín Sosa",
"email": "martin.sosa@nortefresco.example",
"company": "Norte Fresco",
"details": "Necesitamos cubrir la posición antes de diciembre."
}'{
"leadId": "c2d4e6f8-0a1b-4c3d-8e5f-6a7b8c9d0e1f",
"contactId": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60",
"created": true
}created: false significa que la empresa ya existía y la consulta se sumó a ella.
POST /crm/leads/batch/discard
/crm/leads/batch/discardArchiva varias empresas a la vez (con sus pedidos abiertos). Con una API key nunca borra: todas las empresas válidas quedan archivadas (deleted: false). Devuelve qué se aplicó y qué se rechazó por fila.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadIds | uuid[] | Sí | Entre 1 y 200 ids. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/batch/discard \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "leadIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12", "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d"] }'{
"applied": [{ "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12", "deleted": false }],
"refused": [{ "id": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d", "error": "NOT_FOUND" }]
}POST /crm/leads/batch/restore
/crm/leads/batch/restoreRestaura varias empresas archivadas, con los pedidos que se archivaron junto con ellas. applied trae las empresas restauradas (mismo objeto que PATCH, sin totales) y refused las que no estaban archivadas o no existen (NOT_FOUND).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadIds | uuid[] | Sí | Entre 1 y 200 ids. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/batch/restore \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "leadIds": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12"] }'POST /crm/leads/discard-preview
/crm/leads/discard-previewDice cuántas de estas empresas se borrarían y cuántas se archivarían si alguien las descarta desde la app (una empresa que nunca tuvo una vacante se borra; el resto se archiva). No escribe nada. Con una API key el descarte siempre archiva, así que esta ruta es informativa.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| ids | uuid[] | Sí | Entre 1 y 1000 ids de empresas. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/discard-preview \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "ids": ["3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12"] }'{ "deleted": 0, "archived": 1 }Personas
GET /crm/leads/{leadId}/contacts
/crm/leads/{leadId}/contactsLista las personas activas de una empresa (también de una empresa archivada), la principal primero y después por fecha de alta. Pagina: ver Paginación.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa. |
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/contacts \
-H "Authorization: Bearer rcl_..."{
"rows": [
{
"id": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60",
"clientId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12",
"source": "REFERRAL",
"clientName": "Acme Logística",
"firstName": "Lucía",
"lastName": "Ferreyra",
"title": "Directora de Personas",
"email": "lucia@acmelogistica.example",
"phone": "+54 11 5555-0101",
"linkedinUrl": null,
"isPrimary": true,
"isDecisionMaker": true,
"notes": null,
"doNotContactAt": null,
"doNotContactNote": null,
"doNotContactByName": null,
"companyDoNotContact": false,
"archivedAt": null,
"createdAt": "2026-10-02T14:11:10.000Z",
"lastActivityAt": "2026-10-15T16:00:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}source y clientName son de la empresa; companyDoNotContact es true cuando la empresa entera está marcada.
POST /crm/leads/{leadId}/contacts
/crm/leads/{leadId}/contactsAgrega una persona a una empresa. La empresa sale del path (no se manda en el body). Devuelve la persona creada. Acepta Idempotency-Key. Equivale a la acción create_contact.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| firstName | string | Sí | 1 a 120 caracteres. |
| lastName | string | null | Opcional | Hasta 120 caracteres. |
| title | string | null | Opcional | Cargo, hasta 160 caracteres. |
| email | null | Opcional | Email. | |
| phone | string | null | Opcional | Dígitos con separadores habituales y + opcional, mínimo 6 caracteres, hasta 40. |
| linkedinUrl | url | null | Opcional | Perfil de LinkedIn (linkedin.com). |
| isPrimary | boolean | Opcional | Persona principal. Si no se manda, es principal cuando la empresa todavía no tiene una. Marcar una principal desmarca a la anterior. |
| isDecisionMaker | boolean | Opcional | Quien decide. Default false. |
| notes | string | null | Opcional | Hasta 5000 caracteres. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/contacts \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "firstName": "Diego", "lastName": "Paredes", "title": "CFO", "isDecisionMaker": true }'Errores: 409 COMPANY_ARCHIVED si la empresa está archivada; 404 NOT_FOUND si no existe.
GET /crm/contacts/{contactId}
/crm/contacts/{contactId}Devuelve una persona, con la misma forma que una fila de GET /crm/leads/{leadId}/contacts (incluye lastActivityAt). También alcanza a una persona archivada.
curl https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60 \
-H "Authorization: Bearer rcl_..."Error: 404 NOT_FOUND.
PATCH /crm/contacts/{contactId}
/crm/contacts/{contactId}Edita una persona. Acepta los mismos campos que el alta (firstName, lastName, title, email, phone, linkedinUrl, isPrimary, isDecisionMaker, notes), todos opcionales y sin defaults. isPrimary: true desmarca a la principal anterior. Devuelve la persona actualizada. Equivale a la acción update_contact.
curl -X PATCH https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60 \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "title": "VP de Personas", "phone": "+54 11 5555-0199" }'Errores: 400 INVALID con un body vacío; 404 NOT_FOUND; 409 PRIMARY_CHANGED si otra persona de la misma empresa pasó a principal al mismo tiempo (reintenta).
DELETE /crm/contacts/{contactId}
/crm/contacts/{contactId}Una API key no borra personas: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "archive_contact" }]. Archívala con PUT /crm/contacts/{contactId}/archive o con la acción archive_contact.
PUT /crm/contacts/{contactId}/archive
/crm/contacts/{contactId}/archiveArchiva o restaura una persona. Su actividad, su historial y su marca de «no contactar» se conservan; si era la principal, deja de serlo para que la empresa pueda nombrar otra. Contesta 200 con body null. Archivar equivale a la acción archive_contact.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | uuid | Sí | Id de la persona (en el path). |
| archived | boolean | Sí | true archiva, false restaura. |
curl -X PUT https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60/archive \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "archived": true }'Error: 404 NOT_FOUND si no existe o ya estaba en el estado pedido.
PUT /crm/contacts/batch/archive
/crm/contacts/batch/archiveArchiva o restaura varias personas a la vez. applied trae los ids que cambiaron y refused los que no (con error: "NOT_FOUND": no existen o ya estaban en ese estado).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactIds | uuid[] | Sí | Entre 1 y 200 ids. |
| archived | boolean | Sí | true archiva, false restaura. |
curl -X PUT https://app.reclee.com/api/v1/crm/contacts/batch/archive \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "contactIds": ["7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60"], "archived": true }'{ "applied": ["7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60"], "refused": [] }PUT /crm/contacts/{contactId}/do-not-contact
/crm/contacts/{contactId}/do-not-contactMarca a una persona como «no contactar» (pidió que no le escriban). La marca es de la persona: el resto de la empresa sigue siendo contactable, salvo que la persona sea quien decide o que mandes wholeCompany: true, en cuyo caso se marca también la empresa. Solo marca: levantar la marca se hace desde la app. Devuelve la persona. Equivale a la acción set_contact_do_not_contact.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | uuid | Sí | Id de la persona (en el path). |
| note | string | Sí | Motivo, 1 a 500 caracteres. |
| wholeCompany | boolean | Opcional | Pidió que no se contacte a nadie de la empresa. Default false. |
curl -X PUT https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60/do-not-contact \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "note": "Pidió por email no recibir más mensajes.", "wholeCompany": false }'Error: 404 NOT_FOUND.
GET /crm/contacts/{contactId}/history
/crm/contacts/{contactId}/historyLista el historial laboral de una persona: el trabajo actual primero (sin endedOn) y después del más reciente al más viejo. Pagina: ver Paginación.
curl https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60/history \
-H "Authorization: Bearer rcl_..."{
"rows": [
{
"id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"contactId": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60",
"companyName": "Grupo Andino",
"companyId": null,
"role": "Gerente de RR. HH.",
"startedOn": "2021-03-01",
"endedOn": "2024-06-30",
"note": null
}
],
"total": 1,
"page": 1,
"pageSize": 50
}companyId viene cuando esa empresa también está en tu CRM.
POST /crm/contacts/{contactId}/history
/crm/contacts/{contactId}/historyAgrega un trabajo al historial de una persona. Devuelve la entrada creada. Acepta Idempotency-Key. Equivale a la acción add_contact_history.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| companyName | string | Sí | 1 a 200 caracteres. |
| companyId | uuid | null | Opcional | Id de la empresa si también está en tu CRM. |
| role | string | Sí | Cargo, 1 a 160 caracteres. |
| startedOn | date | null | Opcional | AAAA-MM-DD. No puede ser posterior a endedOn. |
| endedOn | date | null | Opcional | AAAA-MM-DD. Si no se manda, es su trabajo actual. |
| note | string | null | Opcional | Hasta 500 caracteres. |
curl -X POST https://app.reclee.com/api/v1/crm/contacts/7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60/history \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "companyName": "Grupo Andino", "role": "Gerente de RR. HH.", "startedOn": "2021-03-01", "endedOn": "2024-06-30" }'PATCH /crm/contact-history/{entryId}
/crm/contact-history/{entryId}Corrige una entrada del historial. Acepta los mismos campos que el alta, todos opcionales (al menos uno). Devuelve la entrada actualizada.
curl -X PATCH https://app.reclee.com/api/v1/crm/contact-history/e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "endedOn": "2024-08-31" }'Errores: 400 INVALID con un body vacío o un período al revés; 404 NOT_FOUND.
DELETE /crm/contact-history/{entryId}
/crm/contact-history/{entryId}Una API key no borra entradas del historial: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "add_contact_history" }]. Corrige la entrada con PATCH /crm/contact-history/{entryId} o carga una nueva con la acción add_contact_history.
Actividad
GET /crm/leads/{leadId}/activity
/crm/leads/{leadId}/activityLista la actividad de una empresa: notas, llamadas, emails y reuniones registradas, y los movimientos y marcas que registra el sistema. Ordena por cuándo pasó (o, si no se indicó, por cuándo se escribió), lo más reciente primero. Pagina: ver Paginación.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | uuid | Sí | Id de la empresa. |
| requestId | uuid | Opcional | Solo la actividad de ese pedido. |
| kind | enum | Opcional | Solo ese tipo: NOTE, CALL, EMAIL, MEETING, MOVE, DO_NOT_CONTACT_SET o DO_NOT_CONTACT_CLEARED. |
| excludeKind | enum | Opcional | Deja afuera ese tipo (por ejemplo MOVE). |
| rootOnly | boolean | Opcional | true deja afuera las respuestas. |
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl "https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/activity?excludeKind=MOVE" \
-H "Authorization: Bearer rcl_..."Respuesta (extracto):
{
"rows": [
{
"id": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"clientId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12",
"requestId": null,
"contactId": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60",
"kind": "CALL",
"body": "Confirmaron presupuesto para dos posiciones.",
"fromStageId": null,
"toStageId": null,
"parentId": null,
"occurredAt": "2026-10-15T16:00:00.000Z",
"createdAt": "2026-10-15T18:20:41.000Z",
"updatedAt": null,
"origin": "API",
"author": { "id": "2f3e4d5c-6b7a-4c8d-9e0f-1a2b3c4d5e6f", "firstName": "Sofía", "lastName": "Ríos", "avatarUrl": null }
}
],
"total": 1,
"page": 1,
"pageSize": 50
}origin dice quién lo escribió: APP, COPILOT (el asistente Ask Reclee), API, MCP o CRON (el sistema). avatarUrl es una URL firmada temporal. fromStageId y toStageId vienen en un MOVE.
POST /crm/leads/{leadId}/activity
/crm/leads/{leadId}/activityRegistra una entrada en la actividad de la empresa, o una respuesta a otra entrada (un solo nivel). Los movimientos de etapa y las marcas de «no contactar» los registra el sistema y no se pueden escribir. Devuelve la entrada creada. Acepta Idempotency-Key. Equivale a la acción log_lead_activity.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| kind | enum | Opcional | NOTE, CALL, EMAIL o MEETING. Default NOTE. |
| body | string | Sí | Texto, 1 a 5000 caracteres. |
| occurredAt | datetime | null | Opcional | Cuándo pasó, ISO 8601 con zona. Si no se manda, cuenta la fecha de escritura. |
| requestId | uuid | null | Opcional | Si la entrada es de un pedido de esta empresa y no de la cuenta en general. |
| contactId | uuid | null | Opcional | Persona de esta empresa con quien fue. Una respuesta toma la de la entrada original. |
| parentId | uuid | null | Opcional | Entrada a la que responde. Tiene que ser de la misma empresa y del mismo pedido, de tipo escribible y no ser a su vez una respuesta. |
curl -X POST https://app.reclee.com/api/v1/crm/leads/3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12/activity \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "CALL",
"body": "Confirmaron presupuesto para dos posiciones.",
"occurredAt": "2026-10-15T13:00:00-03:00",
"contactId": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60"
}'Errores: 400 INVALID si contactId no es de esta empresa o parentId no cumple las reglas; 404 NOT_FOUND si parentId no existe.
PATCH /crm/activity/{activityId}
/crm/activity/{activityId}Corrige el texto de una entrada. Solo la puede corregir quien la escribió, y solo si es una nota, llamada, email o reunión (no un movimiento del sistema). Devuelve la entrada actualizada. Equivale a la acción update_lead_activity.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| activityId | uuid | Sí | Id de la entrada (en el path). |
| body | string | Sí | Texto nuevo, 1 a 5000 caracteres. |
curl -X PATCH https://app.reclee.com/api/v1/crm/activity/4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "body": "Confirmaron presupuesto para tres posiciones." }'Errores: 404 NOT_FOUND si no existe o la escribió otra persona; 400 INVALID si es una entrada del sistema.
DELETE /crm/activity/{activityId}
/crm/activity/{activityId}Una API key no borra actividad: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "update_lead_activity" }]. Corrige la entrada con PATCH /crm/activity/{activityId} o con la acción update_lead_activity.
Pedidos
Un pedido es una búsqueda que un cliente le encarga a tu agencia: cuántas posiciones, el rango salarial y el fee. Nace en DRAFT y avanza por SENT, IN_PROGRESS (arranca la búsqueda y vuelve cliente a la empresa), CLOSED o CANCELLED. Para atarle una vacante usa la acción link_request_to_job_post.
GET /crm/requests
/crm/requestsLista los pedidos, del más reciente al más viejo, con cuántas posiciones ya se cubrieron y lo facturado. Pagina: ver Paginación.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| clientId | uuid | Opcional | Solo los pedidos de esa empresa. |
| status | enum | Opcional | DRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED. |
| archived | boolean | Opcional | true lista SOLO los archivados. Si no se manda, no aparecen. |
| page | integer | Opcional | Página, desde 1. Default 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
curl "https://app.reclee.com/api/v1/crm/requests?status=IN_PROGRESS" \
-H "Authorization: Bearer rcl_..."Respuesta (extracto, una fila):
{
"rows": [
{
"id": "9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f",
"clientId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12",
"title": "Jefe/a de depósito — planta Pilar",
"roleTitle": "Jefe de depósito",
"description": null,
"positionsCount": 2,
"salaryMin": 2500,
"salaryMax": 3200,
"currencyCode": "USD",
"salaryPeriod": "MONTHLY",
"feeType": "PERCENTAGE",
"feePct": 20,
"feeAmount": null,
"expectedValueMin": 12000,
"expectedValueMax": 15360,
"expectedCloseDate": "2026-12-15",
"status": "IN_PROGRESS",
"closeReason": null,
"hiringManagerId": "7a1d9e40-2c3b-4f5e-8a6d-1b2c3d4e5f60",
"hiringManagerName": "Lucía Ferreyra",
"hiredCount": 1,
"billedByCurrency": [],
"pendingByCurrency": [{ "currencyCode": "USD", "amount": 7680 }],
"archivedAt": null,
"jobPostId": "d3c2b1a0-9f8e-4d7c-8b6a-5f4e3d2c1b0a",
"isOpen": true,
"requestedAt": "2026-10-03T12:00:00.000Z",
"createdAt": "2026-10-03T12:00:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}expectedValueMin y expectedValueMax los calcula el sistema (salario anualizado × fee × posiciones) y no se escriben. isOpen es true en DRAFT, SENT e IN_PROGRESS.
POST /crm/requests
/crm/requestsCrea un pedido en DRAFT para una empresa. Si no envías fee, el pedido hereda el de la empresa completo (tipo, porcentaje, monto y moneda). Devuelve el pedido creado. Acepta Idempotency-Key. Equivale a la acción create_request.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| clientId | uuid | Sí | Empresa que hace el pedido. |
| title | string | Sí | 1 a 200 caracteres. |
| roleTitle | string | null | Opcional | Puesto, hasta 200 caracteres. |
| description | string | null | Opcional | Hasta 5000 caracteres. |
| positionsCount | integer | Opcional | 1 a 500. Default 1. |
| salaryMin | number | null | Opcional | Mayor o igual a 0 y no mayor que salaryMax. |
| salaryMax | number | null | Opcional | Mayor o igual a 0. |
| currencyCode | string | null | Opcional | Código de 3 letras. |
| salaryPeriod | enum | null | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. Obligatorio si envías salario. |
| feeType | enum | Opcional | PERCENTAGE, FIXED o MIXED. Si no se manda, hereda el fee de la empresa. |
| feePct | number | null | Opcional | 0 a 100. Obligatorio con PERCENTAGE y MIXED; prohibido con FIXED. |
| feeAmount | number | null | Opcional | Mayor que 0. Obligatorio con FIXED y MIXED; prohibido con PERCENTAGE. |
| hiringManagerId | uuid | null | Opcional | Persona de la misma empresa que lleva la búsqueda. |
| expectedCloseDate | date | null | Opcional | AAAA-MM-DD. |
curl -X POST https://app.reclee.com/api/v1/crm/requests \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"clientId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7f3a9c12",
"title": "Jefe/a de depósito — planta Pilar",
"positionsCount": 2,
"salaryMin": 2500,
"salaryMax": 3200,
"currencyCode": "USD",
"salaryPeriod": "MONTHLY"
}'Errores: 409 COMPANY_ARCHIVED; 404 NOT_FOUND si la empresa no existe; 400 HIRING_MANAGER_OUTSIDE_COMPANY si la persona es de otra empresa; 400 INVALID con un rango salarial al revés, salario sin período (SALARY_PERIOD_REQUIRED) o un fee incompleto.
GET /crm/requests/{requestId}
/crm/requests/{requestId}Devuelve un pedido con la misma forma que una fila de GET /crm/requests. También alcanza a uno archivado.
curl https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f \
-H "Authorization: Bearer rcl_..."Error: 404 NOT_FOUND.
PATCH /crm/requests/{requestId}
/crm/requests/{requestId}Edita un pedido. Acepta los mismos campos que el alta salvo clientId, todos opcionales y sin defaults. El rango salarial y el fee se validan contra lo que ya está guardado (por ejemplo, un salaryMax menor que el salaryMin guardado es INVALID). No cambia el estado: para eso está PUT /crm/requests/{requestId}/status. Devuelve el pedido. Equivale a la acción update_request.
curl -X PATCH https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "positionsCount": 3, "expectedCloseDate": "2027-01-31" }'Errores: 400 INVALID; 400 HIRING_MANAGER_OUTSIDE_COMPANY; 404 NOT_FOUND.
DELETE /crm/requests/{requestId}
/crm/requests/{requestId}Una API key no borra pedidos: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "archive_request" }]. Archívalo con PUT /crm/requests/{requestId}/archive (o la acción archive_request), o cancélalo con su motivo con PUT /crm/requests/{requestId}/status.
PUT /crm/requests/{requestId}/status
/crm/requests/{requestId}/statusCambia el estado de un pedido según su ciclo de vida. Cancelar exige motivo; cerrar con menos posiciones cubiertas que las pedidas, también. Devuelve el pedido. Equivale a la acción set_request_status.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | uuid | Sí | Id del pedido (en el path). |
| status | enum | Sí | DRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED. |
| closeReason | string | null | Opcional | Motivo, hasta 2000 caracteres. Obligatorio con CANCELLED y al cerrar sin cubrir todas las posiciones. |
curl -X PUT https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f/status \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "status": "CANCELLED", "closeReason": "El cliente congeló la contratación." }'Errores:
400 INVALID:CANCELLEDsincloseReason(endetailsfiguraREASON_REQUIREDsobrecloseReason).400 REASON_REQUIRED: cerrar sin cubrir todas las posiciones y sin motivo.409 REQUEST_ALREADY_STARTED,409 REQUEST_NOT_STARTED,409 REQUEST_ALREADY_ENDED: la transición no está permitida desde el estado actual.404 NOT_FOUND.
PUT /crm/requests/{requestId}/archive
/crm/requests/{requestId}/archiveArchiva o restaura un pedido. Archivar no es cancelar: lo saca de las listas sin registrar por qué se cayó (para eso está status). Devuelve el pedido. Archivar equivale a la acción archive_request.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | uuid | Sí | Id del pedido (en el path). |
| archived | boolean | Sí | true archiva, false restaura. |
curl -X PUT https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f/archive \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "archived": false }'Error: 404 NOT_FOUND.
POST /crm/requests/batch/discard
/crm/requests/batch/discardArchiva varios pedidos a la vez. Con una API key nunca borra (deleted: false en cada uno). Devuelve { applied, refused } como POST /crm/leads/batch/discard.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestIds | uuid[] | Sí | Entre 1 y 200 ids. |
curl -X POST https://app.reclee.com/api/v1/crm/requests/batch/discard \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "requestIds": ["9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f"] }'{ "applied": [{ "id": "9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f", "deleted": false }], "refused": [] }POST /crm/requests/batch/restore
/crm/requests/batch/restoreRestaura varios pedidos archivados. applied trae los pedidos restaurados y refused los que no se encontraron archivados (NOT_FOUND).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestIds | uuid[] | Sí | Entre 1 y 200 ids. |
curl -X POST https://app.reclee.com/api/v1/crm/requests/batch/restore \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "requestIds": ["9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f"] }'POST /crm/requests/discard-preview
/crm/requests/discard-previewIgual que el de empresas: dice cuántos pedidos se borrarían (los que no tienen vacante) y cuántos se archivarían si se descartan desde la app. No escribe nada.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| ids | uuid[] | Sí | Entre 1 y 1000 ids de pedidos. |
curl -X POST https://app.reclee.com/api/v1/crm/requests/discard-preview \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "ids": ["9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f"] }'{ "deleted": 0, "archived": 1 }Contrataciones
Una contratación es el registro comercial de una persona contratada en la vacante de un pedido: lo que se firmó es lo que se factura. Se crea al contratar desde el ATS; acá se lee y se corrige.
GET /crm/requests/{requestId}/placements
/crm/requests/{requestId}/placementsLista las contrataciones de la vacante que trabaja el pedido, de la más vieja a la más nueva. Un pedido sin vacante devuelve una lista vacía. Pagina: ver Paginación.
curl https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f/placements \
-H "Authorization: Bearer rcl_..."{
"rows": [
{
"placement": {
"id": "f0e1d2c3-b4a5-4968-8776-655443322110",
"applicationId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"type": "HIRE",
"salary": 3000,
"currencyCode": "USD",
"salaryPeriod": "MONTHLY",
"feeType": "PERCENTAGE",
"feePct": 20,
"feeAmount": null,
"startDate": "2026-11-03",
"guaranteeDays": 90,
"guaranteeEndsAt": "2027-02-01",
"replacesPlacementId": null,
"leftAt": null,
"leftReason": null,
"leftNote": null,
"guaranteeActivatedAt": null,
"billingStatus": "PENDING",
"createdAt": "2026-10-20T15:02:11.000Z"
},
"applicationId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"profileId": "6c5b4a39-2817-4f6e-9d5c-4b3a29180716",
"jobPostId": "d3c2b1a0-9f8e-4d7c-8b6a-5f4e3d2c1b0a",
"personName": "Carla Méndez",
"awaitingReplacement": false
}
],
"total": 1,
"page": 1,
"pageSize": 50
}type es HIRE, REPLACEMENT (reemplazo sin fee de una garantía activada) o STAFFING. awaitingReplacement: true indica una garantía activada que todavía nadie reemplazó.
Errores: 400 INVALID si requestId no es un UUID; 404 NOT_FOUND si el pedido no existe.
PATCH /crm/requests/{requestId}/placements/{placementId}
/crm/requests/{requestId}/placements/{placementId}Corrige una contratación: fee, salario, garantía o estado de facturación. Envía solo lo que cambia (al menos un campo); si cambias el tipo de fee, envíalo con sus partes. Devuelve la contratación (el objeto placement del listado).
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | uuid | Sí | Pedido al que pertenece (en el path). |
| placementId | uuid | Sí | Id de la contratación (en el path). |
| feeType | enum | Opcional | PERCENTAGE, FIXED o MIXED. |
| feePct | number | null | Opcional | 0 a 100. |
| feeAmount | number | null | Opcional | Mayor que 0. |
| salary | number | Opcional | Mayor que 0. |
| salaryPeriod | enum | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. |
| currencyCode | string | Opcional | Código de 3 letras. |
| guaranteeDays | integer | Opcional | 1 a 365. |
| billingStatus | enum | Opcional | PENDING, INVOICED, PAID, WAIVED o CANCELLED. |
curl -X PATCH https://app.reclee.com/api/v1/crm/requests/9b8e7d6c-5a4b-4c3d-8e2f-1a0b9c8d7e6f/placements/f0e1d2c3-b4a5-4968-8776-655443322110 \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "billingStatus": "INVOICED" }'Errores: 400 INVALID con un body vacío o un fee incompleto; 404 NOT_FOUND si la contratación no existe o no es de ese pedido.
Importación
Para cargar en lote, el flujo tiene dos pasos: primero subes la planilla a POST /crm/sheet para leer sus columnas, armas tus filas mapeando esas columnas a los campos de Reclee, y después envías las filas como JSON a leads/import, contacts/import o requests/import, de a 100 filas por llamada como máximo. Una importación nunca pisa datos: una empresa o persona que ya existe se cuenta como existente y queda como estaba.
Las tres rutas de importación devuelven el mismo reporte:
{
"created": 48,
"existing": 1,
"failed": [{ "index": 3, "line": 5, "code": "INVALID", "field": "website" }],
"warnings": [{ "index": 10, "line": 12, "code": "CONTACT_FAILED" }]
}failed: filas que no entraron.indexes la posición (desde 0) en elrowsque enviaste,linela línea de la planilla si la enviaste, yfieldel primer campo inválido en unINVALID. Otros códigos:COMPANY_NOT_FOUND(la empresa nombrada no está en el CRM),COMPANY_ARCHIVED,CONTACT_NO_KEY,HIRING_MANAGER_OUTSIDE_COMPANY.warnings: filas que entraron (o coincidieron) pero perdieron una parte, por ejemplo una empresa cuya persona no se pudo agregar (CONTACT_FAILED).
Un valor vacío ("") en un campo opcional cuenta como no enviado.
POST /crm/sheet
/crm/sheetLee una planilla CSV o XLSX y devuelve sus encabezados y filas, sin guardar nada. Se manda como multipart/form-data con el archivo en el campo file. Hasta 2 MB y 5000 filas de datos: un archivo más grande se rechaza entero, nunca se corta.
curl -X POST https://app.reclee.com/api/v1/crm/sheet \
-H "Authorization: Bearer rcl_..." \
-F "file=@empresas.csv"{
"headers": ["Empresa", "Sitio web", "Industria"],
"rows": [
["Acme Logística", "https://acmelogistica.example", "TRANSPORTATION_LOGISTICS"],
["Norte Fresco", "", ""]
],
"lines": [2, 3]
}lines es la línea de la planilla de cada fila (contando el encabezado y las líneas en blanco): envíala como line en cada fila del import para que los errores apunten a la línea correcta.
Errores: 400 INVALID sin campo file; 400 TOO_MANY_ROWS con más de 5000 filas; 413 TOO_LARGE o 413 PAYLOAD_TOO_LARGE por tamaño; 400 OLD_XLS (un .xls anterior a 2007), 400 NOT_A_SHEET, 400 EMPTY o 400 UNREADABLE.
POST /crm/leads/import
/crm/leads/importImporta empresas, cada una con una persona opcional. Todas entran en la primera etapa del embudo. Acepta Idempotency-Key.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| rows | object[] | Sí | Entre 1 y 100 filas. Cada fila se valida por separado. |
| fileName | string | null | Opcional | Nombre del archivo; se guarda como detalle del origen en las filas que no traen sourceDetail. |
| dedup.company | string[] | Opcional | Con qué se detecta una empresa existente: name y/o website. Default ambos. |
| dedup.person | string[] | Opcional | Con qué se detecta una persona existente: email y/o linkedin. Default ambos. |
Campos de cada fila: name (obligatorio), website, linkedinUrl, description, industry, headcountRange, country, timezone, source, sourceDetail, defaultFeeType, defaultFeePct, defaultFeeAmount, defaultCurrencyCode, line, y contact con firstName (obligatorio), lastName, title, email, phone, linkedinUrl. Mismos valores válidos que en POST /crm/leads.
curl -X POST https://app.reclee.com/api/v1/crm/leads/import \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{
"fileName": "empresas.csv",
"rows": [
{
"line": 2,
"name": "Acme Logística",
"website": "https://acmelogistica.example",
"industry": "TRANSPORTATION_LOGISTICS",
"contact": { "firstName": "Lucía", "lastName": "Ferreyra", "email": "lucia@acmelogistica.example" }
}
]
}'POST /crm/contacts/import
/crm/contacts/importImporta personas en empresas que ya están en el CRM: cada fila nombra su empresa con companyName. Acepta Idempotency-Key.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| rows | object[] | Sí | Entre 1 y 100 filas. |
| dedup.person | string[] | Opcional | email y/o linkedin. Default ambos. |
Campos de cada fila: companyName (obligatorio), firstName (obligatorio), lastName, title, email, phone, linkedinUrl, isPrimary, isDecisionMaker, notes, line.
curl -X POST https://app.reclee.com/api/v1/crm/contacts/import \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "rows": [ { "line": 2, "companyName": "Acme Logística", "firstName": "Diego", "lastName": "Paredes", "title": "CFO" } ] }'POST /crm/requests/import
/crm/requests/importImporta pedidos de empresas que ya están en el CRM. Puede traer pedidos históricos que ya terminaron (con status y closeReason). Acepta Idempotency-Key.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| rows | object[] | Sí | Entre 1 y 100 filas. |
Campos de cada fila: companyName (obligatorio), title (obligatorio), description, positionsCount, salaryMin, salaryMax, currencyCode, salaryPeriod, feeType, feePct, feeAmount, expectedCloseDate, status, closeReason, line. Mismos valores válidos que en POST /crm/requests.
curl -X POST https://app.reclee.com/api/v1/crm/requests/import \
-H "Authorization: Bearer rcl_..." \
-H "Content-Type: application/json" \
-d '{ "rows": [ { "line": 2, "companyName": "Acme Logística", "title": "Analista contable", "positionsCount": 1, "status": "CLOSED" } ] }'Errores de la llamada entera (no de una fila): 400 INVALID si rows está vacío o tiene más de 100 elementos.