> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar lead

> Actualiza un lead existente de Famulor a través de la API. Modifica los datos de contacto, las variables personalizadas, el estado y la asignación de campaña para la difusión de IA.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Actualiza un lead proporcionando el ID del lead y los campos que quieres cambiar. Solo se actualizarán los campos incluidos en la solicitud.

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El ID del lead que se va a actualizar
</ParamField>

### Cuerpo de la solicitud

<ParamField body="campaign_id" type="integer">
  El ID de la campaña a la que se debe asignar el lead
</ParamField>

<ParamField body="phone_number" type="string">
  El número de teléfono del lead (se formatea automáticamente a E164)
</ParamField>

<ParamField body="status" type="string">
  El estado del lead. Debe ser uno de los siguientes valores: created, completed, reached-max-retries
</ParamField>

<ParamField body="variables" type="object">
  Variables personalizadas que se combinarán con las variables existentes del lead
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito que indica que el lead se actualizó
</ResponseField>

### Notas

* El lead debe pertenecer al usuario autenticado
* Al actualizar la campaña, la nueva campaña también debe pertenecer al usuario autenticado
* Los números de teléfono se formatean y validan automáticamente
* Las variables se combinan con las variables existentes (no se reemplazan)
* Solo se pueden actualizar los campos permitidos: campaign\_id, phone\_number, status, variables
* El campo status tiene valores restringidos para mantener la integridad de los datos

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "message": "Lead successfully updated"
  }
  ```
</ResponseExample>

<Tip>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>