Kontakte, Custom Fields & Listen

Alles in WeZend hängt am Kontakt — ein Profil pro Mensch, mit Identifikatoren (E-Mail, Telefon), Attributen, Einwilligungsstatus, Event-Historie, Nachrichten und Scores.

Standard- + Custom Fields

Kontakte bringen die Standardfelder mit, die du erwartest (Name, E-Mail, Telefon, Land, Sprache…). Alles andere ist ein Custom Field, das du einmal definierst:

curl -X POST https://api.wezend.com/v1/contacts/fields \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "key": "loyalty_tier", "type": "text", "label": "Treuestufe" }'

Typen: text, number, date, boolean. Einmal definiert, ist das Feld überall verfügbar — in Template-Variablen ({{loyalty_tier}}), im Segment-Builder, auf der Kontaktkarte im Dashboard und in CSV-Importen.

Erstellen & aktualisieren

# Erstellen
curl -X POST https://api.wezend.com/v1/contacts \
  -H "X-API-Key: $WEZEND_API_KEY" -H "Content-Type: application/json" \
  -d '{ "email": "anna@example.com", "phone": "+4512345678", "first_name": "Anna", "loyalty_tier": "gold" }'

# Aktualisieren (partiell — nur die gesendeten Felder ändern sich)
curl -X PATCH https://api.wezend.com/v1/contacts/c_123 \
  -H "X-API-Key: $WEZEND_API_KEY" -H "Content-Type: application/json" \
  -d '{ "loyalty_tier": "platinum" }'

Kontakte werden über E-Mail/Telefon abgeglichen, sodass der doppelte Import derselben Person aktualisiert statt dupliziert.

CSV-Import

Zielgruppe → Kontakte → Importieren (oder POST /v1/contacts/import). Lade die Datei hoch, ordne deine Spalten den Feldern zu (nicht zugeordnete Spalten können direkt zu neuen Custom Fields werden), wähle die Zielliste und bestätige. Importe laufen im Hintergrund mit Fortschrittsanzeige und einem Fehlerbericht pro Zeile — eine falsche Telefonnummer in Zeile 3.481 killt nicht die anderen 50.000 Zeilen.

Listen vs. Segmente — wann man was verwendet

• Eine Liste ist statisch: Kontakte sind darin, weil du sie dort hineingesetzt hast (Import, Formularanmeldung, manuelles Hinzufügen). Die Mitgliedschaft ändert sich nur, wenn etwas sie hinzufügt/entfernt.
• Ein Segment ist live: eine Regel ("ausgegeben > 500 € UND 30 Tage inaktiv"), in die Kontakte automatisch ein- und ausfließen, wenn sich ihre Daten ändern.

Faustregel: Listen für Herkunft ("Frühjahrsmesse-Leads 2026"), Segmente für Zustand ("aktuell mit Abwanderungsrisiko"). Kampagnen und Journeys akzeptieren beide.