Skip to main content
PUT
https://app.famulor.de/api/
/
user
/
leads
/
{id}
curl -X PUT "https://app.famulor.de/api/user/leads/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": 456,
    "phone_number": "+1234567890",
    "variables": {
      "name": "John Doe",
      "company": "Acme Corp"
    }
  }'

{
  "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
curl -X PUT "https://app.famulor.de/api/user/leads/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": 456,
    "phone_number": "+1234567890",
    "variables": {
      "name": "John Doe",
      "company": "Acme Corp"
    }
  }'

{
  "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