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→CLOSEDoCANCELLED). 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.
/actions/create_leadBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre de la empresa. De 1 a 200 caracteres. |
| website | string (url) | null | Opcional | Sitio web. |
| linkedinUrl | string (url) | null | Opcional | URL de LinkedIn (tiene que ser de linkedin.com). |
| description | string | null | Opcional | Máximo 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 o HOLDING_COMPANIES. |
| headcountRange | string | null | Opcional | Rango de empleados, texto libre ('51-200'). Máximo 60 caracteres. |
| country | string | null | Opcional | País. Máximo 120 caracteres. |
| timezone | string | null | Opcional | Zona horaria. Máximo 60 caracteres. |
| contentLocale | enum | null | Opcional | Idioma del contenido para este cliente: es o en. 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. Máximo 200 caracteres. |
| defaultFeeType | enum | Opcional | PERCENTAGE, FIXED o MIXED. Default PERCENTAGE. |
| defaultFeePct | number | null | Opcional | Porcentaje, de 0 a 100. Con PERCENTAGE o MIXED. |
| defaultFeeAmount | number | null | Opcional | Monto fijo, mayor que 0. Obligatorio con FIXED o MIXED. |
| defaultCurrencyCode | string | null | Opcional | Moneda, código de 3 letras (USD). |
| defaultGuaranteeDays | integer | null | Opcional | Días de garantía, de 1 a 365. |
| primaryPerson | object | null | Opcional | Contacto principal a crear con la empresa. |
| primaryPerson.firstName | string | Sí | De 1 a 120 caracteres. |
| primaryPerson.lastName | string | null | Opcional | Máximo 120 caracteres. |
| primaryPerson.title | string | null | Opcional | Cargo. Máximo 160 caracteres. |
| primaryPerson.email | string (email) | null | Opcional | Email. |
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ódigo | HTTP | Cuándo |
|---|---|---|
LEAD_EXISTS | 409 | Ya hay en el embudo una empresa con ese sitio web o nombre. |
INVALID | 400 | El 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.
/actions/update_leadBody
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.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | El lead. |
| name | string | Opcional | De 1 a 200 caracteres. |
| website / linkedinUrl / description | string | null | Opcional | Como en create_lead. |
| industry | enum | null | Opcional | Uno de los grupos de industria de create_lead. |
| headcountRange / country / timezone / sourceDetail | string | null | Opcional | Como en create_lead. |
| contentLocale | enum | null | Opcional | es o en. |
| source | enum | Opcional | COLD_EMAIL, INBOUND_LANDING, REFERRAL, OUTBOUND_LINKEDIN u OTHER. |
| defaultFeeType | enum | Opcional | PERCENTAGE, FIXED o MIXED, con sus partes. |
| defaultFeePct | number | null | Opcional | De 0 a 100. |
| defaultFeeAmount | number | null | Opcional | Mayor que 0. |
| defaultCurrencyCode | string | null | Opcional | Código de 3 letras. |
| defaultGuaranteeDays | integer | Opcional | De 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | No mandaste ningún campo, el fee no trae sus partes, o un valor no pasa la validación. |
NOT_FOUND | 404 | El 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 contestaCLIENT_IS_DERIVED. - Mover a la etapa en la que ya está contesta
INVALID.
El cambio de etapa queda registrado en el timeline del lead.
/actions/move_lead_stageBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | El lead. |
| stageId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
STAGE_ONLY_ADVANCES | 409 | La etapa destino está antes que la actual. |
CLIENT_IS_DERIVED | 409 | Pediste la etapa Client. Pasa un pedido a IN_PROGRESS en su lugar. |
INVALID | 400 | El lead ya está en esa etapa. |
NOT_FOUND | 404 | El 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.
/actions/set_lead_do_not_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | El lead. |
| note | string | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | El 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.
/actions/set_contact_do_not_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | string (uuid) | Sí | La persona. |
| note | string | Sí | El motivo. De 1 a 500 caracteres. |
| wholeCompany | boolean | Opcional | true 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La 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
isPrimarysolo si quieres forzarlo:isPrimary: truele saca la marca de principal a quien la tuviera antes. isDecisionMakeresfalsesi no lo mandas.
/actions/create_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | La empresa. |
| firstName | string | Sí | De 1 a 120 caracteres. |
| lastName | string | null | Opcional | Máximo 120 caracteres. |
| title | string | null | Opcional | Su cargo en la empresa. Máximo 160 caracteres. |
| string (email) | null | Opcional | Email. | |
| phone | string | null | Opcional | Teléfono. Máximo 40 caracteres. |
| linkedinUrl | string (url) | null | Opcional | URL de LinkedIn (tiene que ser de linkedin.com). |
| isPrimary | boolean | Opcional | Contacto principal. Si es true, el principal anterior deja de serlo. |
| isDecisionMaker | boolean | Opcional | Toma decisiones. Default false. |
| notes | string | null | Opcional | Notas. 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ódigo | HTTP | Cuándo |
|---|---|---|
COMPANY_ARCHIVED | 409 | La empresa está archivada. |
NOT_FOUND | 404 | El lead no existe en el workspace. |
INVALID | 400 | Un 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.
/actions/update_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | string (uuid) | Sí | La persona. |
| firstName | string | Opcional | De 1 a 120 caracteres. |
| lastName | string | null | Opcional | Máximo 120 caracteres. |
| title | string | null | Opcional | Cargo. Máximo 160 caracteres. |
| string (email) | null | Opcional | Email. | |
| phone | string | null | Opcional | Máximo 40 caracteres. |
| linkedinUrl | string (url) | null | Opcional | URL de LinkedIn. |
| isPrimary | boolean | Opcional | Contacto principal. |
| isDecisionMaker | boolean | Opcional | Toma decisiones. |
| notes | string | null | Opcional | Má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ódigo | HTTP | Cuándo |
|---|---|---|
PRIMARY_CHANGED | 409 | Otra persona pasó a ser la principal mientras se guardaba. Reintenta. |
NOT_FOUND | 404 | La persona no existe en el workspace. |
INVALID | 400 | No 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).
kindesNOTEsi no lo mandas.MOVEno se acepta: los cambios de etapa los escribe el sistema.occurredAtes 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.requestIdarchiva la entrada bajo uno de los pedidos de la empresa en lugar de la empresa en general.parentIdresponde a una entrada: elactivityIdde otra entrada de la misma empresa (y del mismo pedido). No se puede responder a una respuesta.
/actions/log_lead_activityBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | La empresa. |
| kind | enum | Opcional | NOTE, CALL, EMAIL o MEETING. Default NOTE. |
| body | string | Sí | El texto. De 1 a 5000 caracteres. |
| occurredAt | string (date-time) | null | Opcional | Cuándo pasó, ISO 8601 con zona horaria. Default: ahora. |
| requestId | string (uuid) | null | Opcional | Pedido de la empresa bajo el que se archiva. |
| parentId | string (uuid) | null | Opcional | La entrada a la que responde. |
| contactId | string (uuid) | null | Opcional | La 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | kind 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_FOUND | 404 | La 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,feePctnifeeAmount, el pedido hereda el fee de la empresa completo. Para fijar uno, mandafeeTypecon sus partes (PERCENTAGE:feePct;FIXED:feeAmount;MIXED: los dos). - Salario:
salaryMinosalaryMaxnecesitansalaryPeriod, y el mínimo no puede superar al máximo. hiringManagerIdtiene que ser una persona de la misma empresa.
/actions/create_requestBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| clientId | string (uuid) | Sí | El lead (empresa) que encarga la búsqueda. |
| title | string | Sí | Título del pedido. De 1 a 200 caracteres. |
| roleTitle | string | null | Opcional | Cargo a cubrir. Máximo 200 caracteres. |
| description | string | null | Opcional | Máximo 5000 caracteres. |
| positionsCount | integer | Opcional | Posiciones, de 1 a 500. Default 1. |
| salaryMin | number | null | Opcional | Salario mínimo, 0 o más. Requiere salaryPeriod. |
| salaryMax | number | null | Opcional | Salario máximo, 0 o más. Requiere salaryPeriod. |
| currencyCode | string | null | Opcional | Moneda, código de 3 letras. |
| salaryPeriod | enum | null | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. |
| feeType | enum | Opcional | PERCENTAGE, FIXED o MIXED. Sin fee, hereda el de la empresa. |
| feePct | number | null | Opcional | De 0 a 100. |
| feeAmount | number | null | Opcional | Mayor que 0. |
| hiringManagerId | string (uuid) | null | Opcional | Persona de la misma empresa que decide la contratación. |
| expectedCloseDate | string (date) | null | Opcional | Fecha 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ódigo | HTTP | Cuándo |
|---|---|---|
COMPANY_ARCHIVED | 409 | La empresa está archivada. |
HIRING_MANAGER_OUTSIDE_COMPANY | 400 | hiringManagerId no es una persona de esa empresa. |
NOT_FOUND | 404 | La empresa no existe en el workspace. |
INVALID | 400 | Salario 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.
/actions/update_requestBody
Los mismos campos que create_request, todos opcionales y sin defaults, salvo clientId (un pedido no cambia de empresa), más:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | string (uuid) | Sí | El pedido. |
| title | string | Opcional | De 1 a 200 caracteres. |
| roleTitle / description | string | null | Opcional | Como en create_request. |
| positionsCount | integer | Opcional | De 1 a 500. |
| salaryMin / salaryMax | number | null | Opcional | 0 o más. |
| currencyCode | string | null | Opcional | Código de 3 letras. |
| salaryPeriod | enum | null | Opcional | HOURLY, DAILY, MONTHLY o YEARLY. |
| feeType | enum | Opcional | PERCENTAGE, FIXED o MIXED, con sus partes. |
| feePct / feeAmount | number | null | Opcional | Como en create_request. |
| hiringManagerId | string (uuid) | null | Opcional | Persona de la misma empresa. |
| expectedCloseDate | string (date) | null | Opcional | YYYY-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ódigo | HTTP | Cuándo |
|---|---|---|
HIRING_MANAGER_OUTSIDE_COMPANY | 400 | hiringManagerId no es una persona de la empresa del pedido. |
INVALID | 400 | No mandaste ningún campo, el rango salarial queda invertido, o el fee no trae sus partes. |
NOT_FOUND | 404 | El 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:
DRAFTySENTvan y vienen a mano.IN_PROGRESSarranca la búsqueda y convierte a la empresa en Client en el embudo del CRM.CLOSEDsolo desdeIN_PROGRESS, y necesitacloseReasoncuando se contrató menos gente que las posiciones pedidas.CANCELLEDsiempre necesitacloseReason.- Nada sale de
CLOSEDni deCANCELLED, y un pedidoIN_PROGRESSno vuelve aDRAFTni aSENT.
closeReason se ignora para los demás estados.
/actions/set_request_statusBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | string (uuid) | Sí | El pedido. |
| status | enum | Sí | DRAFT, SENT, IN_PROGRESS, CLOSED o CANCELLED. |
| closeReason | string | null | Opcional | Motivo 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ódigo | HTTP | Cuándo |
|---|---|---|
REASON_REQUIRED | 400 | CANCELLED sin closeReason, o CLOSED con menos contrataciones que posiciones y sin closeReason. |
REQUEST_ALREADY_ENDED | 409 | El pedido ya está CLOSED o CANCELLED. |
REQUEST_NOT_STARTED | 409 | Pediste CLOSED para un pedido que nunca estuvo IN_PROGRESS. |
REQUEST_ALREADY_STARTED | 409 | Pediste DRAFT o SENT para un pedido IN_PROGRESS. |
NOT_FOUND | 404 | El 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.
/actions/link_request_to_job_postBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | string (uuid) | Sí | La vacante. |
| requestId | string (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ódigo | HTTP | Cuándo |
|---|---|---|
REQUEST_ALREADY_LINKED | 409 | El pedido ya respalda otra vacante. |
JOB_POST_ALREADY_LINKED | 409 | La vacante ya tiene un pedido. |
JOB_POST_CLOSED | 409 | La vacante está cerrada. |
NOT_FOUND | 404 | La 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.
/actions/archive_leadBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | La empresa. |
| archived | boolean | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOTHING_TO_CHANGE | 409 | Archivaste una empresa ya archivada, o restauraste una que no lo estaba. |
NOT_FOUND | 404 | La 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).
/actions/archive_requestBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| requestId | string (uuid) | Sí | El pedido. |
| archived | boolean | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOTHING_TO_CHANGE | 409 | Archivaste un pedido ya archivado, o restauraste uno que no lo estaba. |
NOT_FOUND | 404 | El 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.
/actions/archive_contactBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | string (uuid) | Sí | La persona. |
| archived | boolean | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOTHING_TO_CHANGE | 409 | Archivaste a alguien ya archivado, o restauraste a alguien que no lo estaba. |
NOT_FOUND | 404 | La 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.
/actions/update_lead_activityBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| leadId | string (uuid) | Sí | La empresa. |
| activityId | string (uuid) | Sí | La entrada, el id que devolvió log_lead_activity. |
| body | string | Sí | 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ódigo | HTTP | Cuándo |
|---|---|---|
NOT_FOUND | 404 | La entrada no está en el timeline de esa empresa. |
INVALID | 400 | La 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
entryIdagrega un trabajo y necesitacompanyNameyrole. - Con
entryId(una entrada de esa misma persona) cambia solo los campos que mandes. companyIdvincula la empresa cuando también es un lead de tu CRM.startedOnyendedOnson fechasYYYY-MM-DD. SinendedOn, la persona trabaja ahí hoy. Un inicio posterior al fin esINVALID.
/actions/add_contact_historyBody
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| contactId | string (uuid) | Sí | La persona. |
| entryId | string (uuid) | Opcional | La entrada a corregir. Sin él, se agrega una nueva. |
| companyName | string | Opcional | Empresa. De 1 a 200 caracteres. Obligatorio al agregar. |
| companyId | string (uuid) | null | Opcional | El lead de esa empresa, si existe en tu CRM. |
| role | string | Opcional | Cargo. De 1 a 160 caracteres. Obligatorio al agregar. |
| startedOn | string (date) | null | Opcional | Inicio, YYYY-MM-DD. |
| endedOn | string (date) | null | Opcional | Fin, YYYY-MM-DD. Sin él, trabajo actual. |
| note | string | null | Opcional | Nota. 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ódigo | HTTP | Cuándo |
|---|---|---|
INVALID | 400 | Agregar sin companyName o role, inicio posterior al fin, o una corrección sin ningún campo. |
NOT_FOUND | 404 | La persona no existe, o entryId no es una entrada de esa persona. |