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.

Parameter

10 · 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.

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 dem NAMEN des benutzerdefinierten Felds als Schlüssel, z. B. {"Stadt": "Berlin"}. Unbekannte Namen liefern 422. Senden Sie null oder "", um einen Wert zu leeren.

opted_out optional

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

lifecycle_stage optional

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

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

curl -X PUT 'https://app.sendapp.ai/api/contacts/42' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Mario Rossi", "tags": ["cliente", "vip"], "custom_fields": { "City": "Milano" }, "lifecycle_stage": "customer" }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contacts/42'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['name' => 'Mario Rossi', 'tags' => ['cliente', 'vip'], 'custom_fields' => ['City' => 'Milano'], 'lifecycle_stage' => 'customer']), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42', { method: 'PUT', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Mario Rossi', tags: ['cliente', 'vip'], custom_fields: { City: 'Milano' }, lifecycle_stage: 'customer' }) }); console.log(await res.json());

{ "status": "success", "changed": ["name", "tags", "custom_fields", "lifecycle_stage"], "contact": { "id": 42, "name": "Mario Rossi", "tags": ["cliente", "vip"], "lifecycle_stage": "customer", "...": "..." } }