Kontakt aktualisieren

PUT https://app.sendapp.ai/api/contacts/{id}

Aktualisiert ein oder mehrere Felder eines Kontakts. Nur die gesendeten Schlüssel werden geändert; tags ERSETZT die gesamte Menge (nutzen Sie die Tag-Endpunkte, um einzelne Tags hinzuzufügen oder zu entfernen). Jede Änderung wird im Verlauf des Kontakts festgehalten. PATCH wird ebenfalls akzeptiert.

Die Namen der benutzerdefinierten Felder, mit Typ und erlaubten Auswahlwerten, findest du mit GET /api/contact-fields.

Werte nach Typ: Ja/Nein true oder false (auch 1/0, "yes"/"no"), gespeichert als 1/0 wie auf der Seite Kontakte; Zahl eine Zahl (auch "12,5"); Datum YYYY-MM-DD (aus einem ISO-8601-Datum mit Uhrzeit wird das Datum übernommen); Einfachauswahl eine der Auswahlmöglichkeiten; Mehrfachauswahl ein Array von Auswahlmöglichkeiten oder ein Text mit durch Kommas getrennten Auswahlmöglichkeiten. Bei den Auswahlmöglichkeiten spielt Groß- und Kleinschreibung keine Rolle: Der Wert wird in der offiziellen Schreibweise gespeichert. Ein ungültiger Wert ergibt 422 mit invalid_fields, dem Grund für jedes Feld, und es wird nichts geändert.

Felder vom Typ KI füllt die KI von SendApp aus: Sie können nicht geschrieben werden (422, in invalid_fields), aber du liest sie im Kontakt, in custom_fields.

Parameter

18 · 2 Pflichtfelder

apikey erforderlich

Ihr API Key (der Header X-API-Key funktioniert ebenfalls).

id erforderlich

Kontakt-ID (Ganzzahl, im Pfad). Verwenden Sie GET /api/contacts, um sie zu finden.

name optional

Name des Kontakts.

first_name optional

Vorname: Der vollständige Name wird neu zusammengesetzt (hat Vorrang vor name). War der Kontakt noch nicht geteilt, wird die andere Hälfte aus dem aktuellen Namen übernommen.

last_name optional

Nachname: Der vollständige Name wird neu zusammengesetzt.

phone optional

Telefonnummer im internationalen Format. 409, wenn sie bereits zu einem anderen Kontakt gehört.

email optional

E-Mail-Adresse. 409, wenn sie bereits zu einem anderen Kontakt gehört.

birthday optional

Datum im Format YYYY-MM-DD (null zum Löschen).

tags optional

Array oder kommagetrennte Zeichenkette — ersetzt alle Tags.

custom_fields optional

Objekt mit Schlüssel = NAME des benutzerdefinierten Felds, z. B. {"Stadt": "Rom"}. Jeder Wert wird nach dem Typ des Felds geprüft (siehe Hinweise): Unbekannte Namen oder ungültige Werte ergeben 422. Sende null oder "", um einen Wert zu leeren.

opted_out optional

true = von Kampagnen ausschließen, false = wieder anmelden.

requested_by optional

Mit opted_out=true: wer den Opt-out verlangt hat, contact (die Person, Widerruf der Einwilligung; der Wert, wenn das Feld fehlt) oder business (Ihre Entscheidung, die Einwilligung bleibt). Ein anderer Wert liefert 422.

opt_out_reason optional

Mit opted_out=true: Grund in Ihren eigenen Worten (höchstens 191 Zeichen), im Verlauf des Kontakts gespeichert.

consent_ads optional

App «Conversioni pubblicitarie»: consenso del contatto alla misurazione degli annunci (comunicare a Meta il clic sull'annuncio e cosa ha fatto dopo). true = consenso raccolto dal tuo sistema (serve consent_ads_method, altrimenti 422), false = ritiro, vale subito anche per le conversioni in coda. Non è il consenso marketing.

consent_ads_method optional

Obbligatorio con consent_ads=true: come è stato raccolto il consenso, uno tra form, verbal, signature, email, other (con other serve anche consent_ads_text_ref).

consent_ads_text_ref optional

Versione o riferimento del testo che il contatto ha accettato (massimo 191 caratteri), per esempio informativa v3, modulo sito 2026-10.

ads_excluded optional

true = escludi il contatto dalle conversioni pubblicitarie (opposizione); separato da opted_out: i messaggi continuano.

lifecycle_stage optional

Einer der Werte lead, qualified, customer, inactive, lost (null zum Löschen).

Brauchen Sie Hilfe bei der Integration? info@sendapp.live