Kontakter, custom fields & lister

Alt i WeZend hænger på kontakten — én profil pr. menneske, med identifikatorer (email, telefon), attributter, samtykkestatus, eventhistorik, beskeder og scorer.

Standard + custom fields

Kontakter kommer med de standardfelter, du forventer (navn, email, telefon, land, sprog…). Alt andet er et custom field, du definerer én gang:

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

/v1/contacts-API'et accepterer enten en API-nøgle (X-API-Key) eller en dashboard-session (et JWT fra POST /v1/auth/login) — en server-side-integration bruger nøglen. Alt der opretter eller ændrer data kræver en nøgle med write-scope; en nøgle med kun read afvises med 403 insufficient_scope. Feltets nøgle (loyalty_tier) afledes automatisk af labelen. Når feltet er defineret, findes det overalt — i skabelonvariabler ({{loyalty_tier}}), i segment-builderen, på kontaktkortet i dashboardet og i CSV-imports. DELETE /v1/contacts/fields/:id fjerner en definition igen, og den beholder de værdier, der allerede står på kontakterne — så at slette et felt skjuler det fra builderen frem for at slette historik.

Opret & opdatér

# Opret
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", "custom_fields": { "loyalty_tier": "guld" } }'

# Opdatér (partielt — kun de felter du sender, ændres)
curl -X PATCH https://api.wezend.com/v1/contacts/c_123 \
  -H "X-API-Key: $WEZEND_API_KEY" -H "Content-Type: application/json" \
  -d '{ "custom_fields": { "loyalty_tier": "platin" } }'

Kontakter matches på email/telefon, så import af samme person to gange opdaterer i stedet for at duplikere.

CSV-import

Målgruppe → Kontakter → Importér (eller POST /v1/contacts/import). Upload filen, map dine kolonner til felter (ikke-mappede kolonner kan blive nye custom fields på stedet), vælg mål-listen, og bekræft. Imports kører i baggrunden med statusindikator og en fejlrapport pr. række — et dårligt telefonnummer på række 3.481 dræber ikke de andre 50.000 rækker.

Lister vs. segmenter — hvornår bruger man hvad

• En liste er statisk: kontakter er i den, fordi du satte dem der (import, formulartilmelding, manuel tilføjelse). Medlemskab ændrer sig kun, når noget tilføjer/fjerner dem.
• Et segment er levende: en regel ("brugt > 500 € OG inaktiv 30 dage"), som kontakter automatisk flyder ind og ud af, når deres data ændrer sig.

Tommelfingerregel: lister til proveniens ("Forårsmesse-leads 2026"), segmenter til tilstand ("aktuelt i churn-risiko"). Kampagner og journeys accepterer begge.

Lists-API'et

Lister bruger de samme to legitimationer som kontakter — en API-nøgle (X-API-Key) eller et dashboard-JWT. Alt herunder ud over læsningerne er en skrivning, så en nøgle med kun read-scope får 403 insufficient_scope.

# Opret en liste
curl -X POST https://api.wezend.com/v1/lists \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Forårsmesse-leads 2026", "description": "Stand-scanninger" }'

# Tilføj en kontakt der allerede findes
curl -X POST https://api.wezend.com/v1/lists/$LIST_ID/contacts \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contact_id": "c_123" }'

# Importér en CSV direkte ind i listen (multipart, maks. 50 MB)
curl -X POST https://api.wezend.com/v1/lists/$LIST_ID/import \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -F "file=@leads.csv"

GET /v1/lists og GET /v1/lists/:id læser dem, PATCH /v1/lists/:id omdøber en, PATCH /v1/lists/:id/favorite fastgør den i dashboardet, og DELETE /v1/lists/:id samt DELETE /v1/lists/:id/contacts/:contactId fjerner en liste eller et enkelt medlemskab. At tilføje en kontakt to gange er en no-op frem for en fejl, så en import I kører igen, dublerer ingen.