Actualizar Lead #

Usa este método para actualizar información asociada a un lead existente en el ecosistema relacionando los campos y valores a modificar en el registro.

URL del endpoint #

POST /update-lead

Parámetros de entrada #

Los parámetros deben enviarse en el cuerpo de la solicitud HTTP en formato JSON. A continuación, se detallan los parámetros requeridos:

Parámetro	Tipo	Descripción
id	string	Identificador único (UUID) del lead
name	str	(opcional): Nombre del lead.
lastname	str	(opcional): Apellido del lead.
nit	str	(opcional): NIT o número de identificación del lead.
phone	str	(opcional): Número de teléfono del lead.
email	str	(opcional): Dirección de correo electrónico del lead.
address	str	(opcional): Dirección del lead.
business_entity	str	(opcional): Entidad empresarial del lead.
business_name	str	(opcional): Nombre de la empresa del lead.
lead_status	str	(opcional): Estado del lead.
records	list	(opcional): Lista de registros asociados al lead.
history	list	(opcional): Historial del lead.
score	int	(opcional): Puntaje del lead.
created_at	str	(opcional): Fecha de creación del lead.
loan_priority	str	(opcional): Prioridad del préstamo del lead.
image	str	(opcional): URL de la imagen asociada al lead.
additional_data	dict	(opcional): Datos adicionales del lead.

Encabezados #

Respuesta esperada #

El método devuelve una respuesta en formato JSON con los siguientes campos:

• En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:

{
  "id": "string",
  "image": "string",
  "name": "string",
  "lastname": "string",
  "business_name": "string",
  "quota": 0,
  "status": "string",
  "phone": "string",
  "email": "string",
  "nit": "string",
  "address": "string",
  "history": [],
  "score": 0.0,
  "payment_data": {},
  "apn_token": "string",
  "ecosystem": "string",
  "business_entity": "string",
  "additional_data": {}
}

Donde:

• id: ID del lead.
• image (opcional): URL de la imagen asociada al lead.
• name: Nombre del lead.
• lastname: Apellido del lead.
• business_name: Nombre de la empresa del lead.
• quota: Cuota del lead.
• status: Estado del lead.
• phone: Número de teléfono del lead.
• email: Dirección de correo electrónico del lead.
• nit: NIT del lead.
• address: Dirección del lead.
• history (opcional): Historial del lead.
• score (opcional): Puntaje del lead.
• payment_data (opcional): Datos de pago del lead.
• apn_token (opcional): Token de APN (Apple Push Notification) asociado al lead.
• ecosystem: Ecosistema del lead.
• business_entity: Entidad empresarial del lead.
• additional_data (opcional): Datos adicionales del lead.

Ejemplos de uso #

Python #

import requests
import json

url = "https://api.leancore.co/update-lead"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
data = {
    "id": "fd3705e1-3149-4c41-bfe7-cf0bee79cfad",
    "name": "John",
    "lastname": "Doe",
    "phone": "1234567890"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    updated_lead = response.json()
    print("Lead actualizado:")
    print(updated_lead)
else:
    print("Error al actualizar el lead. Código de respuesta:", response.status_code)
    print("Mensaje de error:", response.text)