Kontakt erstellen

POST https://app.sendapp.ai/api/contacts

Erstellt (oder aktualisiert per Upsert) einen einzelnen Kontakt. Er muss mindestens eine Telefonnummer ODER eine E-Mail haben. Bestehende Kontakte mit derselben Telefonnummer/E-Mail werden zusammengeführt (Tags kombiniert, Metadaten zusammengeführt).

Antworten: 201 Created mit dem erstellten Kontakt — 403, wenn das Kontaktlimit des Plans erreicht ist — 422, wenn sowohl Telefon als auch E-Mail fehlen.

Du kannst die benutzerdefinierten Felder schon beim Anlegen mit custom_fields schreiben, nach Name, mit denselben Regeln wie bei Kontakt aktualisieren: Ein unbekannter Name oder ein ungültiger Wert ergeben 422, und der Kontakt wird nicht gespeichert. Gibt es den Kontakt schon, ersetzen die gesendeten Werte die gespeicherten, leere Werte werden ignoriert. Die Namen der Felder findest du mit GET /api/contact-fields.

Parameter

9 · 3 Pflichtfelder

apikey erforderlich

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

name optional

Vollständiger Name, bis zu 255 Zeichen.

first_name optional

Vorname. Mit first_name und/oder last_name wird der vollständige Name aus diesen zusammengesetzt (sie haben Vorrang vor name).

last_name optional

Nachname.

phone erforderlich

Internationales Format (z. B. +393391234567). Erforderlich, wenn die E-Mail fehlt.

email erforderlich

Gültige E-Mail. Erforderlich, wenn die Telefonnummer fehlt.

tags optional

Array von Strings oder kommagetrennter String (z. B. "vip,newsletter").

metadata optional

JSON-Objekt mit benutzerdefinierten Feldern.

custom_fields optional

Objekt mit Schlüssel = NAME des benutzerdefinierten Felds, z. B. {"Stadt": "Rom", "Newsletter": true}. Jeder Wert wird nach dem Typ des Felds geprüft, wie bei Kontakt aktualisieren.

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

curl -X POST 'https://app.sendapp.ai/api/contacts' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Mario Rossi", "phone": "+393391234567", "email": "mario@example.com", "tags": ["newsletter", "vip"], "metadata": { "source": "landing_page_a" }, "custom_fields": { "City": "Milano" } }'

<?php $ch = curl_init('https://app.sendapp.ai/api/contacts'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'name' => 'Mario Rossi', 'phone' => '+393391234567', 'email' => 'mario@example.com', 'tags' => ['newsletter', 'vip'], 'metadata' => ['source' => 'landing_page_a'], 'custom_fields' => ['City' => 'Milano'], ]), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Mario Rossi', phone: '+393391234567', email: 'mario@example.com', tags: ['newsletter', 'vip'], metadata: { source: 'landing_page_a' }, custom_fields: { City: 'Milano' } }) }); console.log(await res.json());

{ "status": "success", "contact": { "id": 4022, "name": "Giulia Bianchi", "first_name": "Giulia", "last_name": "Bianchi", "phone": "393334455667", "email": "giulia.bianchi@example.com", "tags": [ "lead" ], "metadata": { "source": "api", "created_via": "api", "custom_12": "Milano" }, "created_at": "2026-07-13 10:00:00", "updated_at": "2026-07-13 10:00:00", "custom_fields": { "City": "Milano", "Newsletter": null } } }