Reclee

CRM

Acciones para gestionar empresas cliente, sus personas de contacto, el timeline de actividad y los pedidos de búsqueda.

El CRM de Reclee es donde tu agencia sigue a sus empresas cliente desde el primer contacto hasta que encargan búsquedas. Tiene cuatro objetos:

  • Lead (empresa): una empresa en el embudo comercial. Avanza por etapas propias del CRM —Prospect → Qualified → Meeting— y llega a Client sola, cuando uno de sus pedidos pasa a IN_PROGRESS. Guarda el fee y la garantía por defecto que se le cobran.
  • Contacto (persona): alguien del lado del cliente, dentro de un lead. Uno puede ser el contacto principal y cualquiera puede ser tomador de decisiones. Tiene su propia historia laboral.
  • Actividad: el timeline del lead: notas, llamadas, emails y reuniones, con respuestas de un nivel. Los movimientos de etapa los escribe el sistema.
  • Pedido (request): una búsqueda que el cliente encarga, con posiciones, salario, fee y un ciclo de vida (DRAFT → SENT → IN_PROGRESS → CLOSED o CANCELLED). Un pedido se vincula a una vacante, y la contratación que salga de ella hereda su fee.

Un flujo típico: create_lead → create_contact → log_lead_activity a medida que hablan → move_lead_stage → create_request → set_request_status a IN_PROGRESS → link_request_to_job_post. Los ids se leen con GET /crm/leads, GET /crm/leads/{leadId}/contacts, GET /crm/requests y GET /crm/stages (o las tools de lectura list_leads, list_contacts, list_requests y list_crm_stages).

En el CRM nada se borra por API: empresas, personas y pedidos se archivan, y las entradas del timeline y de la historia laboral se corrigen.

Cómo se llama una acción

POST https://app.reclee.com/api/v1/actions/<nombre> con body JSON y Authorization: Bearer rcl_…. Todas las acciones de esta página son de la familia CRM y no consumen créditos ni uso. La respuesta trae data y links (la URL absoluta del objeto en la app). Las acciones del CRM no devuelven next. Los errores comunes están en Errores.

create_lead

Familia: CRM · No consume créditos.

Crea un lead (una empresa cliente) en la etapa Prospect. name es el único campo obligatorio; source es OTHER si no lo mandas.

Fee y garantía. Si no los mandas, la empresa toma los del workspace. Para fijar un fee propio, manda defaultFeeType con sus partes: PERCENTAGE lleva defaultFeePct; FIXED lleva defaultFeeAmount; MIXED lleva los dos. Una parte que no corresponde al tipo se rechaza.

Persona principal. Si mandas primaryPerson, se crea junto con la empresa como su contacto principal. Es todo o nada: si la persona no se puede crear, la empresa tampoco queda creada y la acción contesta el error de la persona.

Una empresa que ya está en el embudo (mismo sitio web o mismo nombre) nunca se crea dos veces: la acción contesta LEAD_EXISTS, y la existente se encuentra con GET /crm/leads.

POST/actions/create_lead

Body

CampoTipoRequeridoDescripción
namestringSíNombre de la empresa. De 1 a 200 caracteres.
websitestring (url) | nullOpcionalSitio web.
linkedinUrlstring (url) | nullOpcionalURL de LinkedIn (tiene que ser de linkedin.com).
descriptionstring | nullOpcionalMáximo 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 o HOLDING_COMPANIES.
headcountRangestring | nullOpcionalRango de empleados, texto libre ('51-200'). Máximo 60 caracteres.
countrystring | nullOpcionalPaís. Máximo 120 caracteres.
timezonestring | nullOpcionalZona horaria. Máximo 60 caracteres.
contentLocaleenum | nullOpcionalIdioma del contenido para este cliente: es o en. null usa el del workspace.
sourceenumOpcionalCOLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER. Default OTHER.
sourceDetailstring | nullOpcionalDetalle del origen. Máximo 200 caracteres.
defaultFeeTypeenumOpcionalPERCENTAGE, FIXED o MIXED. Default PERCENTAGE.
defaultFeePctnumber | nullOpcionalPorcentaje, de 0 a 100. Con PERCENTAGE o MIXED.
defaultFeeAmountnumber | nullOpcionalMonto fijo, mayor que 0. Obligatorio con FIXED o MIXED.
defaultCurrencyCodestring | nullOpcionalMoneda, código de 3 letras (USD).
defaultGuaranteeDaysinteger | nullOpcionalDías de garantía, de 1 a 365.
primaryPersonobject | nullOpcionalContacto principal a crear con la empresa.
primaryPerson.firstNamestringSíDe 1 a 120 caracteres.
primaryPerson.lastNamestring | nullOpcionalMáximo 120 caracteres.
primaryPerson.titlestring | nullOpcionalCargo. Máximo 160 caracteres.
primaryPerson.emailstring (email) | nullOpcionalEmail.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_lead \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Andes Pay",
    "website": "https://andespay.example",
    "industry": "FINANCIAL_SERVICES",
    "country": "Argentina",
    "source": "REFERRAL",
    "sourceDetail": "Referido por Nubeluz",
    "defaultFeeType": "PERCENTAGE",
    "defaultFeePct": 18,
    "defaultCurrencyCode": "USD",
    "defaultGuaranteeDays": 90,
    "primaryPerson": {
      "firstName": "Carolina",
      "lastName": "Méndez",
      "title": "Head of People",
      "email": "carolina.mendez@andespay.example"
    }
  }'

Respuesta

{
  "data": { "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c" },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
LEAD_EXISTS409Ya hay en el embudo una empresa con ese sitio web o nombre.
INVALID400El body no pasa la validación, por ejemplo un fee FIXED sin monto o un linkedinUrl que no es de LinkedIn. details dice qué campo.

update_lead

Familia: CRM · No consume créditos.

Edita los campos propios de un lead. Hace falta al menos un campo además de leadId. Para cambiar el fee, manda defaultFeeType con sus partes completas (PERCENTAGE: defaultFeePct; FIXED: defaultFeeAmount; MIXED: los dos). No mueve al lead de etapa: eso es move_lead_stage, con sus propias reglas.

POST/actions/update_lead

Body

Los mismos campos que create_lead (salvo primaryPerson), todos opcionales, más leadId. A diferencia de la creación, no hay defaults: lo que no mandas no cambia.

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíEl lead.
namestringOpcionalDe 1 a 200 caracteres.
website / linkedinUrl / descriptionstring | nullOpcionalComo en create_lead.
industryenum | nullOpcionalUno de los grupos de industria de create_lead.
headcountRange / country / timezone / sourceDetailstring | nullOpcionalComo en create_lead.
contentLocaleenum | nullOpcionales o en.
sourceenumOpcionalCOLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER.
defaultFeeTypeenumOpcionalPERCENTAGE, FIXED o MIXED, con sus partes.
defaultFeePctnumber | nullOpcionalDe 0 a 100.
defaultFeeAmountnumber | nullOpcionalMayor que 0.
defaultCurrencyCodestring | nullOpcionalCódigo de 3 letras.
defaultGuaranteeDaysintegerOpcionalDe 1 a 365.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_lead \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "headcountRange": "201-500",
    "defaultFeeType": "MIXED",
    "defaultFeePct": 12,
    "defaultFeeAmount": 1500
  }'

Respuesta

{
  "data": { "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c" },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
INVALID400No mandaste ningún campo, el fee no trae sus partes, o un valor no pasa la validación.
NOT_FOUND404El lead no existe en el workspace.

move_lead_stage

Familia: CRM · No consume créditos.

Mueve una empresa hacia adelante en el embudo del CRM (que es distinto del pipeline de una vacante): Prospect → Qualified → Meeting. El stageId sale de GET /crm/stages (o la tool list_crm_stages).

  • El embudo solo avanza: volver atrás contesta STAGE_ONLY_ADVANCES.
  • Client nunca es un destino: una empresa llega sola cuando uno de sus pedidos pasa a IN_PROGRESS (set_request_status). Pedirla contesta CLIENT_IS_DERIVED.
  • Mover a la etapa en la que ya está contesta INVALID.

El cambio de etapa queda registrado en el timeline del lead.

POST/actions/move_lead_stage

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíEl lead.
stageIdstring (uuid)SíLa etapa destino.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/move_lead_stage \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "stageId": "2c4e6a8b-0d1f-4e3a-9b5c-7d9f1a3c5e7b"
  }'

Respuesta

{
  "data": {
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "stageId": "2c4e6a8b-0d1f-4e3a-9b5c-7d9f1a3c5e7b"
  },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
STAGE_ONLY_ADVANCES409La etapa destino está antes que la actual.
CLIENT_IS_DERIVED409Pediste la etapa Client. Pasa un pedido a IN_PROGRESS en su lugar.
INVALID400El lead ya está en esa etapa.
NOT_FOUND404El lead o la etapa no existen.

set_lead_do_not_contact

Familia: CRM · No consume créditos.

Marca una empresa como «no contactar»: nadie de esa empresa se contacta más. Lleva una nota con el motivo. Una empresa ya marcada conserva su primera marca. Esta acción solo marca: levantar la marca lo hace una persona desde la app.

POST/actions/set_lead_do_not_contact

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíEl lead.
notestringSíEl motivo. De 1 a 500 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_lead_do_not_contact \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "note": "Firmaron exclusividad con otra consultora hasta 2027."
  }'

Respuesta

{
  "data": { "doNotContact": true },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404El lead no existe en el workspace.

set_contact_do_not_contact

Familia: CRM · No consume créditos.

Marca a una persona del lado del cliente como «no contactar»: es una baja real, la persona pidió que no le escriban. Lleva una nota con el motivo. La marca se extiende a toda la empresa cuando la persona es tomadora de decisiones, o cuando pidió la baja de toda la empresa (wholeCompany: true): en esos casos nadie de la empresa se contacta más. Esta acción solo marca: levantar la marca lo hace una persona desde la app.

POST/actions/set_contact_do_not_contact

Body

CampoTipoRequeridoDescripción
contactIdstring (uuid)SíLa persona.
notestringSíEl motivo. De 1 a 500 caracteres.
wholeCompanybooleanOpcionaltrue extiende la marca a toda la empresa.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_contact_do_not_contact \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
    "note": "Respondió pidiendo la baja de los mails."
  }'

Respuesta

{
  "data": { "doNotContact": true },
  "links": [
    {
      "kind": "contact",
      "id": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
      "label": "Carolina Méndez",
      "href": "https://app.reclee.com/crm/people/f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La persona no existe en el workspace.

create_contact

Familia: CRM · No consume créditos.

Crea una persona del lado del cliente dentro de un lead. firstName es el único obligatorio, pero un contacto sin email ni LinkedIn sirve de poco: conviene mandar al menos uno.

  • Principal: el primer contacto de una empresa queda como principal automáticamente; los siguientes no. Manda isPrimary solo si quieres forzarlo: isPrimary: true le saca la marca de principal a quien la tuviera antes.
  • isDecisionMaker es false si no lo mandas.
POST/actions/create_contact

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíLa empresa.
firstNamestringSíDe 1 a 120 caracteres.
lastNamestring | nullOpcionalMáximo 120 caracteres.
titlestring | nullOpcionalSu cargo en la empresa. Máximo 160 caracteres.
emailstring (email) | nullOpcionalEmail.
phonestring | nullOpcionalTeléfono. Máximo 40 caracteres.
linkedinUrlstring (url) | nullOpcionalURL de LinkedIn (tiene que ser de linkedin.com).
isPrimarybooleanOpcionalContacto principal. Si es true, el principal anterior deja de serlo.
isDecisionMakerbooleanOpcionalToma decisiones. Default false.
notesstring | nullOpcionalNotas. Máximo 5000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_contact \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "firstName": "Tomás",
    "lastName": "Aguirre",
    "title": "CTO",
    "email": "tomas.aguirre@andespay.example",
    "isDecisionMaker": true
  }'

Respuesta

{
  "data": { "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c" },
  "links": [
    {
      "kind": "contact",
      "id": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
      "label": "Tomás Aguirre",
      "href": "https://app.reclee.com/crm/people/f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c"
    },
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
COMPANY_ARCHIVED409La empresa está archivada.
NOT_FOUND404El lead no existe en el workspace.
INVALID400Un campo no pasa la validación (email, URL de LinkedIn).

update_contact

Familia: CRM · No consume créditos.

Edita los campos propios de una persona del CRM. Hace falta al menos un campo además de contactId. Igual que al crear, isPrimary: true le saca la marca de principal a quien la tuviera antes en esa empresa.

POST/actions/update_contact

Body

CampoTipoRequeridoDescripción
contactIdstring (uuid)SíLa persona.
firstNamestringOpcionalDe 1 a 120 caracteres.
lastNamestring | nullOpcionalMáximo 120 caracteres.
titlestring | nullOpcionalCargo. Máximo 160 caracteres.
emailstring (email) | nullOpcionalEmail.
phonestring | nullOpcionalMáximo 40 caracteres.
linkedinUrlstring (url) | nullOpcionalURL de LinkedIn.
isPrimarybooleanOpcionalContacto principal.
isDecisionMakerbooleanOpcionalToma decisiones.
notesstring | nullOpcionalMáximo 5000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_contact \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
    "isPrimary": true,
    "phone": "+54 11 5555 0199"
  }'

Respuesta

{
  "data": { "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c" },
  "links": [
    {
      "kind": "contact",
      "id": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
      "label": "Tomás Aguirre",
      "href": "https://app.reclee.com/crm/people/f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c"
    }
  ]
}

Errores

CódigoHTTPCuándo
PRIMARY_CHANGED409Otra persona pasó a ser la principal mientras se guardaba. Reintenta.
NOT_FOUND404La persona no existe en el workspace.
INVALID400No mandaste ningún campo, o un valor no pasa la validación.

log_lead_activity

Familia: CRM · No consume créditos.

Agrega una entrada al timeline de una empresa: una nota, una llamada, un email o una reunión. Ahí vive el historial de contactos con una empresa y su gente (la historia laboral de una persona es otra cosa: add_contact_history).

  • kind es NOTE si no lo mandas. MOVE no se acepta: los cambios de etapa los escribe el sistema.
  • occurredAt es cuándo pasó, no cuándo se registra. Mándalo cuando lo que registras ocurrió otro día u hora («la llamé el viernes»); si no, la entrada queda con la fecha actual.
  • requestId archiva la entrada bajo uno de los pedidos de la empresa en lugar de la empresa en general.
  • parentId responde a una entrada: el activityId de otra entrada de la misma empresa (y del mismo pedido). No se puede responder a una respuesta.
POST/actions/log_lead_activity

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíLa empresa.
kindenumOpcionalNOTE, CALL, EMAIL o MEETING. Default NOTE.
bodystringSíEl texto. De 1 a 5000 caracteres.
occurredAtstring (date-time) | nullOpcionalCuándo pasó, ISO 8601 con zona horaria. Default: ahora.
requestIdstring (uuid) | nullOpcionalPedido de la empresa bajo el que se archiva.
parentIdstring (uuid) | nullOpcionalLa entrada a la que responde.
contactIdstring (uuid) | nullOpcionalLa persona de la empresa con quien fue la nota, la llamada o la reunión. Tiene que ser un contacto de esta misma empresa.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/log_lead_activity \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "kind": "CALL",
    "body": "Llamada con Carolina: abren dos posiciones de backend en noviembre.",
    "occurredAt": "2026-10-16T15:30:00-03:00"
  }'

Respuesta

{
  "data": { "activityId": "7e9a1c3e-5b7d-4f9a-8b1c-3d5e7f9a1b2c" },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
INVALID400kind no es uno de los cuatro, parentId es una respuesta o es de otra empresa o pedido, requestId no es de esta empresa o contactId es una persona de otra empresa.
NOT_FOUND404La empresa, el pedido o la entrada padre no existen.

create_request

Familia: CRM · No consume créditos.

Crea un pedido de búsqueda de una empresa cliente. Siempre nace en DRAFT. clientId es el leadId de la empresa, y title el único otro campo obligatorio; positionsCount es 1 si no lo mandas.

  • Fee: si no mandas feeType, feePct ni feeAmount, el pedido hereda el fee de la empresa completo. Para fijar uno, manda feeType con sus partes (PERCENTAGE: feePct; FIXED: feeAmount; MIXED: los dos).
  • Salario: salaryMin o salaryMax necesitan salaryPeriod, y el mínimo no puede superar al máximo.
  • hiringManagerId tiene que ser una persona de la misma empresa.
POST/actions/create_request

Body

CampoTipoRequeridoDescripción
clientIdstring (uuid)SíEl lead (empresa) que encarga la búsqueda.
titlestringSíTítulo del pedido. De 1 a 200 caracteres.
roleTitlestring | nullOpcionalCargo a cubrir. Máximo 200 caracteres.
descriptionstring | nullOpcionalMáximo 5000 caracteres.
positionsCountintegerOpcionalPosiciones, de 1 a 500. Default 1.
salaryMinnumber | nullOpcionalSalario mínimo, 0 o más. Requiere salaryPeriod.
salaryMaxnumber | nullOpcionalSalario máximo, 0 o más. Requiere salaryPeriod.
currencyCodestring | nullOpcionalMoneda, código de 3 letras.
salaryPeriodenum | nullOpcionalHOURLY, DAILY, MONTHLY o YEARLY.
feeTypeenumOpcionalPERCENTAGE, FIXED o MIXED. Sin fee, hereda el de la empresa.
feePctnumber | nullOpcionalDe 0 a 100.
feeAmountnumber | nullOpcionalMayor que 0.
hiringManagerIdstring (uuid) | nullOpcionalPersona de la misma empresa que decide la contratación.
expectedCloseDatestring (date) | nullOpcionalFecha estimada de cierre, YYYY-MM-DD.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/create_request \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "title": "Backend Go — equipo de pagos",
    "roleTitle": "Senior Backend Engineer",
    "positionsCount": 2,
    "salaryMin": 4500,
    "salaryMax": 6000,
    "currencyCode": "USD",
    "salaryPeriod": "MONTHLY",
    "hiringManagerId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
    "expectedCloseDate": "2026-12-15"
  }'

Respuesta

{
  "data": { "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d" },
  "links": [
    {
      "kind": "request",
      "id": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
      "label": "Backend Go — equipo de pagos",
      "href": "https://app.reclee.com/crm/requests/1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
    }
  ]
}

Errores

CódigoHTTPCuándo
COMPANY_ARCHIVED409La empresa está archivada.
HIRING_MANAGER_OUTSIDE_COMPANY400hiringManagerId no es una persona de esa empresa.
NOT_FOUND404La empresa no existe en el workspace.
INVALID400Salario sin período, mínimo mayor que el máximo, o un fee sin sus partes.

update_request

Familia: CRM · No consume créditos.

Edita los campos propios de un pedido. Hace falta al menos un campo además de requestId. Un cambio de fee lleva feeType con sus partes; un rango salarial se valida contra lo que ya está guardado (mandar solo un salaryMax menor que el mínimo guardado es INVALID). No cambia el estado: eso es set_request_status.

POST/actions/update_request

Body

Los mismos campos que create_request, todos opcionales y sin defaults, salvo clientId (un pedido no cambia de empresa), más:

CampoTipoRequeridoDescripción
requestIdstring (uuid)SíEl pedido.
titlestringOpcionalDe 1 a 200 caracteres.
roleTitle / descriptionstring | nullOpcionalComo en create_request.
positionsCountintegerOpcionalDe 1 a 500.
salaryMin / salaryMaxnumber | nullOpcional0 o más.
currencyCodestring | nullOpcionalCódigo de 3 letras.
salaryPeriodenum | nullOpcionalHOURLY, DAILY, MONTHLY o YEARLY.
feeTypeenumOpcionalPERCENTAGE, FIXED o MIXED, con sus partes.
feePct / feeAmountnumber | nullOpcionalComo en create_request.
hiringManagerIdstring (uuid) | nullOpcionalPersona de la misma empresa.
expectedCloseDatestring (date) | nullOpcionalYYYY-MM-DD.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_request \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
    "positionsCount": 3,
    "feeType": "FIXED",
    "feeAmount": 7000
  }'

Respuesta

{
  "data": { "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d" },
  "links": [
    {
      "kind": "request",
      "id": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
      "label": "Backend Go — equipo de pagos",
      "href": "https://app.reclee.com/crm/requests/1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
    }
  ]
}

Errores

CódigoHTTPCuándo
HIRING_MANAGER_OUTSIDE_COMPANY400hiringManagerId no es una persona de la empresa del pedido.
INVALID400No mandaste ningún campo, el rango salarial queda invertido, o el fee no trae sus partes.
NOT_FOUND404El pedido no existe en el workspace.

set_request_status

Familia: CRM · No consume créditos.

Cambia el estado de un pedido. El ciclo de vida:

  • DRAFT y SENT van y vienen a mano.
  • IN_PROGRESS arranca la búsqueda y convierte a la empresa en Client en el embudo del CRM.
  • CLOSED solo desde IN_PROGRESS, y necesita closeReason cuando se contrató menos gente que las posiciones pedidas.
  • CANCELLED siempre necesita closeReason.
  • Nada sale de CLOSED ni de CANCELLED, y un pedido IN_PROGRESS no vuelve a DRAFT ni a SENT.

closeReason se ignora para los demás estados.

POST/actions/set_request_status

Body

CampoTipoRequeridoDescripción
requestIdstring (uuid)SíEl pedido.
statusenumSíDRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED.
closeReasonstring | nullOpcionalMotivo de cierre o cancelación. Máximo 2000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/set_request_status \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
    "status": "IN_PROGRESS"
  }'

Respuesta

{
  "data": {
    "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
    "status": "IN_PROGRESS"
  },
  "links": [
    {
      "kind": "request",
      "id": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
      "label": "Backend Go — equipo de pagos",
      "href": "https://app.reclee.com/crm/requests/1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
    }
  ]
}

Errores

CódigoHTTPCuándo
REASON_REQUIRED400CANCELLED sin closeReason, o CLOSED con menos contrataciones que posiciones y sin closeReason.
REQUEST_ALREADY_ENDED409El pedido ya está CLOSED o CANCELLED.
REQUEST_NOT_STARTED409Pediste CLOSED para un pedido que nunca estuvo IN_PROGRESS.
REQUEST_ALREADY_STARTED409Pediste DRAFT o SENT para un pedido IN_PROGRESS.
NOT_FOUND404El pedido no existe en el workspace.

link_request_to_job_post

Familia: CRM · No consume créditos.

Vincula el pedido de un cliente a una vacante: la contratación que esa vacante produzca después hereda el fee del pedido. Un vínculo se hace una sola vez y nada lo rehace: el pedido no puede estar vinculado a otra vacante, ni la vacante tener ya un pedido propio. La vacante no puede estar cerrada.

POST/actions/link_request_to_job_post

Body

CampoTipoRequeridoDescripción
jobPostIdstring (uuid)SíLa vacante.
requestIdstring (uuid)SíEl pedido, todavía sin vacante.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/link_request_to_job_post \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90",
    "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
  }'

Respuesta

{
  "data": {
    "jobPostId": "2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90",
    "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
  },
  "links": [
    {
      "kind": "job_post",
      "id": "2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90",
      "label": "Senior Backend Engineer (Go)",
      "href": "https://app.reclee.com/job-posts/2e4a6c8d-0f1b-4d3e-a5c7-9e1b3d5f7a90/overview"
    },
    {
      "kind": "request",
      "id": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
      "label": "Backend Go — equipo de pagos",
      "href": "https://app.reclee.com/crm/requests/1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
    }
  ]
}

Errores

CódigoHTTPCuándo
REQUEST_ALREADY_LINKED409El pedido ya respalda otra vacante.
JOB_POST_ALREADY_LINKED409La vacante ya tiene un pedido.
JOB_POST_CLOSED409La vacante está cerrada.
NOT_FOUND404La vacante o el pedido no existen en el workspace.

archive_lead

Familia: CRM · No consume créditos.

Archiva una empresa junto con sus pedidos abiertos, o la restaura con archived: false. No se borra nada: sus personas, su timeline, sus pedidos y sus contrataciones quedan; solo sale del embudo. Un lead no se borra por API: archivar es la alternativa.

POST/actions/archive_lead

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíLa empresa.
archivedbooleanSítrue archiva; false restaura.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/archive_lead \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c", "archived": true }'

Respuesta

{
  "data": { "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c", "archived": true },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOTHING_TO_CHANGE409Archivaste una empresa ya archivada, o restauraste una que no lo estaba.
NOT_FOUND404La empresa no existe en el workspace.

archive_request

Familia: CRM · No consume créditos.

Archiva un pedido, o lo restaura con archived: false. Archivar es para un pedido cargado dos veces o por error: sale de la pantalla de pedidos, no se borra nada, y una vacante que haya abierto lo sigue referenciando. Si el cliente desistió, no lo archives: cancélalo con set_request_status (CANCELLED con su motivo).

POST/actions/archive_request

Body

CampoTipoRequeridoDescripción
requestIdstring (uuid)SíEl pedido.
archivedbooleanSítrue archiva; false restaura.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/archive_request \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d", "archived": true }'

Respuesta

{
  "data": { "requestId": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d", "archived": true },
  "links": [
    {
      "kind": "request",
      "id": "1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d",
      "label": "Backend Go — equipo de pagos",
      "href": "https://app.reclee.com/crm/requests/1b3d5f7a-9c2e-4d4f-a6b8-0c2e4f6a8b0d"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOTHING_TO_CHANGE409Archivaste un pedido ya archivado, o restauraste uno que no lo estaba.
NOT_FOUND404El pedido no existe en el workspace.

archive_contact

Familia: CRM · No consume créditos.

Archiva a una persona del CRM, o la restaura con archived: false. No se borra nada: su historia y su marca de «no contactar» quedan. Archivarla le saca la marca de principal. Una persona no se borra por API: archivar es la alternativa.

POST/actions/archive_contact

Body

CampoTipoRequeridoDescripción
contactIdstring (uuid)SíLa persona.
archivedbooleanSítrue archiva; false restaura.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/archive_contact \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{ "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c", "archived": true }'

Respuesta

{
  "data": { "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c", "archived": true },
  "links": [
    {
      "kind": "contact",
      "id": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
      "label": "Tomás Aguirre",
      "href": "https://app.reclee.com/crm/people/f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOTHING_TO_CHANGE409Archivaste a alguien ya archivado, o restauraste a alguien que no lo estaba.
NOT_FOUND404La persona no existe en el workspace.

update_lead_activity

Familia: CRM · No consume créditos.

Reescribe el texto de una entrada del timeline que registró la misma persona que llama (nota, llamada, email o reunión). Las entradas se corrigen, no se borran. body reemplaza el texto completo. Una entrada que escribió otra persona, una de otra empresa, o un cambio de etapa del sistema contestan NOT_FOUND o INVALID.

POST/actions/update_lead_activity

Body

CampoTipoRequeridoDescripción
leadIdstring (uuid)SíLa empresa.
activityIdstring (uuid)SíLa entrada, el id que devolvió log_lead_activity.
bodystringSíEl texto nuevo completo. De 1 a 5000 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/update_lead_activity \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
    "activityId": "7e9a1c3e-5b7d-4f9a-8b1c-3d5e7f9a1b2c",
    "body": "Llamada con Carolina: abren tres posiciones de backend en noviembre."
  }'

Respuesta

{
  "data": { "activityId": "7e9a1c3e-5b7d-4f9a-8b1c-3d5e7f9a1b2c" },
  "links": [
    {
      "kind": "lead",
      "id": "d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c",
      "label": "Andes Pay",
      "href": "https://app.reclee.com/crm/pipeline/d9f1b3c5-7e9a-4b2d-8c4e-6f8a0b2d4f6c"
    }
  ]
}

Errores

CódigoHTTPCuándo
NOT_FOUND404La entrada no está en el timeline de esa empresa.
INVALID400La entrada no es editable por quien llama (la escribió otra persona, o es un cambio de etapa).

add_contact_history

Familia: CRM · No consume créditos.

Agrega un trabajo (pasado o actual) a la historia laboral de una persona del CRM, o corrige uno existente. La historia se corrige, no se borra. No es el registro de lo que se habló con ella: llamadas, emails y reuniones van al timeline de su empresa con log_lead_activity.

  • Sin entryId agrega un trabajo y necesita companyName y role.
  • Con entryId (una entrada de esa misma persona) cambia solo los campos que mandes.
  • companyId vincula la empresa cuando también es un lead de tu CRM.
  • startedOn y endedOn son fechas YYYY-MM-DD. Sin endedOn, la persona trabaja ahí hoy. Un inicio posterior al fin es INVALID.
POST/actions/add_contact_history

Body

CampoTipoRequeridoDescripción
contactIdstring (uuid)SíLa persona.
entryIdstring (uuid)OpcionalLa entrada a corregir. Sin él, se agrega una nueva.
companyNamestringOpcionalEmpresa. De 1 a 200 caracteres. Obligatorio al agregar.
companyIdstring (uuid) | nullOpcionalEl lead de esa empresa, si existe en tu CRM.
rolestringOpcionalCargo. De 1 a 160 caracteres. Obligatorio al agregar.
startedOnstring (date) | nullOpcionalInicio, YYYY-MM-DD.
endedOnstring (date) | nullOpcionalFin, YYYY-MM-DD. Sin él, trabajo actual.
notestring | nullOpcionalNota. Máximo 500 caracteres.

Ejemplo

curl -X POST https://app.reclee.com/api/v1/actions/add_contact_history \
  -H "Authorization: Bearer rcl_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
    "companyName": "Nubeluz",
    "role": "VP Engineering",
    "startedOn": "2021-02-01",
    "endedOn": "2024-06-30"
  }'

Respuesta

{
  "data": { "entryId": "8a0c2e4f-6b8d-4a1c-9e3f-5b7d9f1a3c5e" },
  "links": [
    {
      "kind": "contact",
      "id": "f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c",
      "label": "Tomás Aguirre",
      "href": "https://app.reclee.com/crm/people/f0a2c4e6-8b1d-4f3a-9c5e-7a9b1d3f5e7c"
    }
  ]
}

Errores

CódigoHTTPCuándo
INVALID400Agregar sin companyName o role, inicio posterior al fin, o una corrección sin ningún campo.
NOT_FOUND404La persona no existe, o entryId no es una entrada de esa persona.

En esta página