---
title: "Update Lead"
method: PUT
path: "/user/leads/{id}"
tags: ["Leads"]
---

# Update Lead

`PUT /user/leads/{id}`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/leads/{id}`
- Auth: HTTP bearer

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

[Docs](https://docs.famulor.io/api-v1/leads/update)

## Path parameters

- `id` integer, required

## Request body

- object
  - `campaign_id` integer: The ID of the campaign to which the lead should be assigned
  - `phone_number` string: The lead's phone number (automatically formatted to E164)
  - `status` string: The status of the lead. Must be one of the following values: created, completed, reached-max-retries
  - `variables` object: Custom variables to be merged with the existing lead variables

## Response `200`

Response

- object
  - `message` string: Success message indicating the lead was updated

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)