Kontakter, custom fields & lister

Alt i WeZend henger på kontakten — én profil per menneske, med identifikatorer (email, telefon), attributter, samtykkestatus, event-historikk, meldinger og poeng.

Standard + custom fields

Kontakter kommer med standardfeltene du forventer (navn, email, telefon, land, språk…). Alt annet 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": "Lojalitetsnivå" }'

/v1/contacts-API-et aksepterer enten en API-nøkkel (X-API-Key) eller en dashbord-økt (et JWT fra POST /v1/auth/login) — en server-side-integrasjon bruker nøkkelen. Alt som oppretter eller endrer data krever en nøkkel med write-scope; en nøkkel med bare read avvises med 403 insufficient_scope. Feltets nøkkel (loyalty_tier) avledes automatisk fra etiketten. Når feltet er definert, finnes det overalt — i malvariabler ({{loyalty_tier}}), i segment-byggeren, på kontaktkortet i dashbordet og i CSV-import. DELETE /v1/contacts/fields/:id fjerner en definisjon igjen, og den beholder verdiene som allerede står på kontaktene — å slette et felt skjuler det fra byggeren framfor å slette historikk.

Opprett & oppdater

# Opprett
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": "gull" } }'

# Oppdater (delvis — kun feltene du sender, endres)
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": "platina" } }'

Kontakter matches på email/telefon, så import av samme person to ganger oppdaterer i stedet for å duplisere.

CSV-import

Målgruppe → Kontakter → Importer (eller POST /v1/contacts/import). Last opp filen, mapp kolonnene dine til felt (umappede kolonner kan bli nye custom fields på stedet), velg mållisten, og bekreft. Import kjøres i bakgrunnen med en fremdriftsindikator og en feilrapport per rad — et dårlig telefonnummer på rad 3 481 dreper ikke de andre 50 000 radene.

Lister vs. segmenter — når bruker man hva

• En liste er statisk: kontakter er i den fordi du satte dem der (import, skjemapåmelding, manuell tillegg). Medlemskapet endres bare når noe legger til/fjerner dem.
• Et segment er levende: en regel ("brukt > 500 € OG inaktiv 30 dager") som kontakter automatisk flyter inn og ut av når dataene deres endres.

Tommelfingerregel: lister for proveniens ("Vårmesse-leads 2026"), segmenter for tilstand ("akkurat nå i churn-risiko"). Kampanjer og journeys aksepterer begge.

Lists-API-et

Lister bruker de samme to legitimasjonene som kontakter — en API-nøkkel (X-API-Key) eller et dashbord-JWT. Alt under bortsett fra lesingene er en skriving, så en nøkkel med bare read-scope får 403 insufficient_scope.

# Opprett 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": "Vårmesse-leads 2026", "description": "Stand-skanninger" }'

# Legg til en kontakt som allerede finnes
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" }'

# Importer en CSV rett inn 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 leser dem, PATCH /v1/lists/:id gir nytt navn, PATCH /v1/lists/:id/favorite fester den i dashbordet, og DELETE /v1/lists/:id samt DELETE /v1/lists/:id/contacts/:contactId fjerner en liste eller et enkelt medlemskap. Å legge til en kontakt to ganger er en no-op framfor en feil, så en import du kjører på nytt dupliserer ingen.