Zum Hauptinhalt springen
PUT
/
api
/
leads
/
{id}
Lead aktualisieren
curl --request PUT \
  --url https://app.famulor.de/api/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": 123,
  "phone_number": "<string>",
  "status": "<string>",
  "variables": {}
}
'
{
  "message": "Lead erfolgreich aktualisiert"
}
Aktualisieren Sie einen Lead, indem Sie die Lead-ID und die Felder angeben, die Sie ändern möchten. Es werden nur die im Request angegebenen Felder aktualisiert.

​
Pfad-Parameter

​
id
integer
erforderlich
Die ID des zu aktualisierenden Leads

​
Anfrage-Body

​
campaign_id
integer
Die ID der Kampagne, der der Lead zugewiesen werden soll
​
phone_number
string
Die Telefonnummer des Leads (wird automatisch ins E164-Format formatiert)
​
status
string
Der Status des Leads. Muss einer der folgenden Werte sein: created, completed, reached-max-retries
​
variables
object
Benutzerdefinierte Variablen, die mit den bestehenden Lead-Variablen zusammengeführt werden

​
Antwort-Felder

​
message
string
Erfolgsmeldung, die anzeigt, dass der Lead aktualisiert wurde

​
Hinweise

  • Der Lead muss dem authentifizierten Benutzer gehören
  • Bei der Aktualisierung der Kampagne muss die neue Kampagne ebenfalls dem authentifizierten Benutzer gehören
  • Telefonnummern werden automatisch formatiert und validiert
  • Variablen werden mit bestehenden Variablen zusammengeführt (nicht ersetzt)
  • Nur erlaubte Felder können aktualisiert werden: campaign_id, phone_number, status, variables
  • Das Status-Feld hat eingeschränkte Werte für die Datenintegrität
{
  "message": "Lead erfolgreich aktualisiert"
}
Passende Seiten: Introduction und Authentication Guide und API Integration Examples.