Skip to main content
PUT
https://app.famulor.de/api/
/
user
/
leads
/
{id}
Update Lead
curl --request PUT \
  --url https://app.famulor.de/api/user/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": 123,
  "phone_number": "<string>",
  "status": "<string>",
  "variables": {}
}
'
{
  "message": "Lead updated successfully"
}
Update one or more fields of an existing lead. Only the fields you provide will be changed; all other fields remain unchanged.

​
Path Parameters

​
id
integer
required
The unique identifier of the lead to update

​
Body Parameters

​
campaign_id
integer
Move the lead to a different campaign by providing the new campaign ID
​
phone_number
string
Update the lead’s phone number (will be automatically formatted to E164 standard)
​
status
string
Set the lead status. Valid values: created, completed, reached-max-retries
​
variables
object
Update or add custom variables. These will be merged with existing variables, not replaced

​
Response

​
message
string
Success message confirming the update
{
  "message": "Lead updated successfully"
}

​
Notes

  • The lead must belong to your account
  • If changing the campaign, the new campaign must also be yours
  • Phone numbers are automatically validated and formatted
  • Variables are merged with existing ones (partial updates are supported)
  • Only these fields can be modified: campaign_id, phone_number, status, variables
  • Status field has restrictions to maintain data integrity