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

# Update Lead

> Update an existing Famulor lead via API. Modify contact information, custom variables, status and campaign assignment for AI voice outreach.

Update a lead by providing the lead ID and the fields you want to change. Only the fields included in the request will be updated.

### Path Parameters

<ParamField path="id" type="integer" required>
  The ID of the lead to be updated
</ParamField>

### Request Body

<ParamField body="campaign_id" type="integer">
  The ID of the campaign to which the lead should be assigned
</ParamField>

<ParamField body="phone_number" type="string">
  The lead's phone number (automatically formatted to E164)
</ParamField>

<ParamField body="status" type="string">
  The status of the lead. Must be one of the following values: created, completed, reached-max-retries
</ParamField>

<ParamField body="variables" type="object">
  Custom variables to be merged with the existing lead variables
</ParamField>

### Response Fields

<ResponseField name="message" type="string">
  Success message indicating the lead was updated
</ResponseField>

### Notes

* The lead must belong to the authenticated user
* When updating the campaign, the new campaign must also belong to the authenticated user
* Phone numbers are automatically formatted and validated
* Variables are merged with existing variables (not replaced)
* Only allowed fields can be updated: campaign\_id, phone\_number, status, variables
* The status field has restricted values to maintain data integrity

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

<Tip>
  Related pages: [Introduction](/en/api-reference/introduction) and [Authentication Guide](/en/developers/authentication-guide), and [API Integration Examples](/en/developers/api-integration-examples).
</Tip>