Reclee

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

GET/crm/stages

Devuelve 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

GET/crm/leads

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

CampoTipoRequeridoDescripción
stageIduuidOpcionalSolo las empresas en esa etapa (ver GET /crm/stages).
sourceenumOpcionalOrigen: COLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER.
searchstringOpcionalCoincidencia parcial en el nombre, sin distinguir mayúsculas ni acentos.
archivedbooleanOpcionaltrue lista SOLO las archivadas. Si no se manda, las archivadas no aparecen.
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/crm/leads

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

CampoTipoRequeridoDescripción
namestringSíNombre de la empresa, 1 a 200 caracteres.
websiteurl | nullOpcionalSitio web. Se usa también para detectar duplicados.
linkedinUrlurl | nullOpcionalURL de LinkedIn (tiene que ser de linkedin.com).
descriptionstring | nullOpcionalHasta 5000 caracteres.
industryenum | nullOpcionalTECHNOLOGY_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.
headcountRangestring | nullOpcionalTamaño, texto libre de hasta 60 caracteres (p. ej. 51-200).
countrystring | nullOpcionalHasta 120 caracteres.
timezonestring | nullOpcionalHasta 60 caracteres (p. ej. America/Mexico_City).
contentLocalees | en | nullOpcionalIdioma en que se le escribe a este cliente. null usa el del workspace.
sourceenumOpcionalCOLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER. Default OTHER.
sourceDetailstring | nullOpcionalDetalle del origen, hasta 200 caracteres.
stageIduuid | nullOpcionalEtapa inicial. Solo PROSPECTING, QUALIFIED o MEETING. Si no se manda, PROSPECTING.
defaultFeeTypeenumOpcionalPERCENTAGE, FIXED o MIXED. Default PERCENTAGE.
defaultFeePctnumber | nullOpcional0 a 100. Con PERCENTAGE se puede omitir: toma el del workspace. Obligatorio con MIXED; prohibido con FIXED.
defaultFeeAmountnumber | nullOpcionalMonto fijo, mayor que 0. Obligatorio con FIXED y MIXED; prohibido con PERCENTAGE.
defaultCurrencyCodestring | nullOpcionalCódigo de 3 letras (USD, ARS, MXN...).
defaultGuaranteeDaysinteger | nullOpcionalDías de garantía de cada contratación, 1 a 365. Si no se manda, el del workspace.
primaryPersonobject | nullOpcionalPersona 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: stageId no es una de las tres etapas manuales.

  • 400 INVALID: el fee no tiene las partes que pide su tipo (details dice FEE_PCT_REQUIRED, FEE_AMOUNT_REQUIRED, FEE_PCT_NOT_ALLOWED o FEE_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}

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

CampoTipoRequeridoDescripción
leadIduuidSí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}

PATCH/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}

DELETE/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

PUT/crm/leads/{leadId}/archive

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

CampoTipoRequeridoDescripción
leadIduuidSíId de la empresa (en el path).
archivedbooleanSí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

PUT/crm/leads/{leadId}/stage

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

CampoTipoRequeridoDescripción
leadIduuidSíId de la empresa (en el path).
stageIduuidSí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

PUT/crm/leads/{leadId}/do-not-contact

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

CampoTipoRequeridoDescripción
leadIduuidSíId de la empresa (en el path).
notestringSí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

POST/crm/leads/intake

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

CampoTipoRequeridoDescripción
rolestringSíQué puesto buscan, 1 a 200 caracteres.
namestringSíNombre de quien consulta, 1 a 240 caracteres.
emailemailSíEmail de quien consulta. Identifica a la persona.
phonestring | nullOpcionalHasta 40 caracteres.
companystring | nullOpcionalNombre de la empresa, hasta 200 caracteres. Se busca una existente por nombre.
detailsstring | nullOpcionalDetalle de la consulta, hasta 5000 caracteres.
channelFORM | CALLOpcionalPor dónde llegó. Default FORM.
bookedAtdatetime | nullOpcionalSolo 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

POST/crm/leads/batch/discard

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

CampoTipoRequeridoDescripción
leadIdsuuid[]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

POST/crm/leads/batch/restore

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

CampoTipoRequeridoDescripción
leadIdsuuid[]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

POST/crm/leads/discard-preview

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

CampoTipoRequeridoDescripción
idsuuid[]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

GET/crm/leads/{leadId}/contacts

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

CampoTipoRequeridoDescripción
leadIduuidSíId de la empresa.
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/crm/leads/{leadId}/contacts

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

CampoTipoRequeridoDescripción
firstNamestringSí1 a 120 caracteres.
lastNamestring | nullOpcionalHasta 120 caracteres.
titlestring | nullOpcionalCargo, hasta 160 caracteres.
emailemail | nullOpcionalEmail.
phonestring | nullOpcionalDígitos con separadores habituales y + opcional, mínimo 6 caracteres, hasta 40.
linkedinUrlurl | nullOpcionalPerfil de LinkedIn (linkedin.com).
isPrimarybooleanOpcionalPersona principal. Si no se manda, es principal cuando la empresa todavía no tiene una. Marcar una principal desmarca a la anterior.
isDecisionMakerbooleanOpcionalQuien decide. Default false.
notesstring | nullOpcionalHasta 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}

GET/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}

PATCH/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}

DELETE/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

PUT/crm/contacts/{contactId}/archive

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

CampoTipoRequeridoDescripción
contactIduuidSíId de la persona (en el path).
archivedbooleanSí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

PUT/crm/contacts/batch/archive

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

CampoTipoRequeridoDescripción
contactIdsuuid[]SíEntre 1 y 200 ids.
archivedbooleanSí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

PUT/crm/contacts/{contactId}/do-not-contact

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

CampoTipoRequeridoDescripción
contactIduuidSíId de la persona (en el path).
notestringSíMotivo, 1 a 500 caracteres.
wholeCompanybooleanOpcionalPidió 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

GET/crm/contacts/{contactId}/history

Lista 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

POST/crm/contacts/{contactId}/history

Agrega un trabajo al historial de una persona. Devuelve la entrada creada. Acepta Idempotency-Key. Equivale a la acción add_contact_history.

CampoTipoRequeridoDescripción
companyNamestringSí1 a 200 caracteres.
companyIduuid | nullOpcionalId de la empresa si también está en tu CRM.
rolestringSíCargo, 1 a 160 caracteres.
startedOndate | nullOpcionalAAAA-MM-DD. No puede ser posterior a endedOn.
endedOndate | nullOpcionalAAAA-MM-DD. Si no se manda, es su trabajo actual.
notestring | nullOpcionalHasta 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}

PATCH/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}

DELETE/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

GET/crm/leads/{leadId}/activity

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

CampoTipoRequeridoDescripción
leadIduuidSíId de la empresa.
requestIduuidOpcionalSolo la actividad de ese pedido.
kindenumOpcionalSolo ese tipo: NOTE, CALL, EMAIL, MEETING, MOVE, DO_NOT_CONTACT_SET o DO_NOT_CONTACT_CLEARED.
excludeKindenumOpcionalDeja afuera ese tipo (por ejemplo MOVE).
rootOnlybooleanOpcionaltrue deja afuera las respuestas.
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/crm/leads/{leadId}/activity

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

CampoTipoRequeridoDescripción
kindenumOpcionalNOTE, CALL, EMAIL o MEETING. Default NOTE.
bodystringSíTexto, 1 a 5000 caracteres.
occurredAtdatetime | nullOpcionalCuándo pasó, ISO 8601 con zona. Si no se manda, cuenta la fecha de escritura.
requestIduuid | nullOpcionalSi la entrada es de un pedido de esta empresa y no de la cuenta en general.
contactIduuid | nullOpcionalPersona de esta empresa con quien fue. Una respuesta toma la de la entrada original.
parentIduuid | nullOpcionalEntrada 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}

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

CampoTipoRequeridoDescripción
activityIduuidSíId de la entrada (en el path).
bodystringSí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}

DELETE/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

GET/crm/requests

Lista los pedidos, del más reciente al más viejo, con cuántas posiciones ya se cubrieron y lo facturado. Pagina: ver Paginación.

CampoTipoRequeridoDescripción
clientIduuidOpcionalSolo los pedidos de esa empresa.
statusenumOpcionalDRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED.
archivedbooleanOpcionaltrue lista SOLO los archivados. Si no se manda, no aparecen.
pageintegerOpcionalPágina, desde 1. Default 1.
pageSizeintegerOpcionalFilas 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

POST/crm/requests

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

CampoTipoRequeridoDescripción
clientIduuidSíEmpresa que hace el pedido.
titlestringSí1 a 200 caracteres.
roleTitlestring | nullOpcionalPuesto, hasta 200 caracteres.
descriptionstring | nullOpcionalHasta 5000 caracteres.
positionsCountintegerOpcional1 a 500. Default 1.
salaryMinnumber | nullOpcionalMayor o igual a 0 y no mayor que salaryMax.
salaryMaxnumber | nullOpcionalMayor o igual a 0.
currencyCodestring | nullOpcionalCódigo de 3 letras.
salaryPeriodenum | nullOpcionalHOURLY, DAILY, MONTHLY o YEARLY. Obligatorio si envías salario.
feeTypeenumOpcionalPERCENTAGE, FIXED o MIXED. Si no se manda, hereda el fee de la empresa.
feePctnumber | nullOpcional0 a 100. Obligatorio con PERCENTAGE y MIXED; prohibido con FIXED.
feeAmountnumber | nullOpcionalMayor que 0. Obligatorio con FIXED y MIXED; prohibido con PERCENTAGE.
hiringManagerIduuid | nullOpcionalPersona de la misma empresa que lleva la búsqueda.
expectedCloseDatedate | nullOpcionalAAAA-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}

GET/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}

PATCH/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}

DELETE/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

PUT/crm/requests/{requestId}/status

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

CampoTipoRequeridoDescripción
requestIduuidSíId del pedido (en el path).
statusenumSíDRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED.
closeReasonstring | nullOpcionalMotivo, 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: CANCELLED sin closeReason (en details figura REASON_REQUIRED sobre closeReason).
  • 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

PUT/crm/requests/{requestId}/archive

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

CampoTipoRequeridoDescripción
requestIduuidSíId del pedido (en el path).
archivedbooleanSí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

POST/crm/requests/batch/discard

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

CampoTipoRequeridoDescripción
requestIdsuuid[]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

POST/crm/requests/batch/restore

Restaura varios pedidos archivados. applied trae los pedidos restaurados y refused los que no se encontraron archivados (NOT_FOUND).

CampoTipoRequeridoDescripción
requestIdsuuid[]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

POST/crm/requests/discard-preview

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

CampoTipoRequeridoDescripción
idsuuid[]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

GET/crm/requests/{requestId}/placements

Lista 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}

PATCH/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).

CampoTipoRequeridoDescripción
requestIduuidSíPedido al que pertenece (en el path).
placementIduuidSíId de la contratación (en el path).
feeTypeenumOpcionalPERCENTAGE, FIXED o MIXED.
feePctnumber | nullOpcional0 a 100.
feeAmountnumber | nullOpcionalMayor que 0.
salarynumberOpcionalMayor que 0.
salaryPeriodenumOpcionalHOURLY, DAILY, MONTHLY o YEARLY.
currencyCodestringOpcionalCódigo de 3 letras.
guaranteeDaysintegerOpcional1 a 365.
billingStatusenumOpcionalPENDING, 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. index es la posición (desde 0) en el rows que enviaste, line la línea de la planilla si la enviaste, y field el primer campo inválido en un INVALID. 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

POST/crm/sheet

Lee 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

POST/crm/leads/import

Importa empresas, cada una con una persona opcional. Todas entran en la primera etapa del embudo. Acepta Idempotency-Key.

CampoTipoRequeridoDescripción
rowsobject[]SíEntre 1 y 100 filas. Cada fila se valida por separado.
fileNamestring | nullOpcionalNombre del archivo; se guarda como detalle del origen en las filas que no traen sourceDetail.
dedup.companystring[]OpcionalCon qué se detecta una empresa existente: name y/o website. Default ambos.
dedup.personstring[]OpcionalCon 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

POST/crm/contacts/import

Importa personas en empresas que ya están en el CRM: cada fila nombra su empresa con companyName. Acepta Idempotency-Key.

CampoTipoRequeridoDescripción
rowsobject[]SíEntre 1 y 100 filas.
dedup.personstring[]Opcionalemail 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

POST/crm/requests/import

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

CampoTipoRequeridoDescripción
rowsobject[]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.

En esta página