Kontakter, custom fields & listor

Allt i WeZend hänger på kontakten — en profil per människa, med identifierare (email, telefon), attribut, samtyckesstatus, event-historik, meddelanden och poäng.

Standard + custom fields

Kontakter kommer med de standardfält du förväntar dig (namn, email, telefon, land, språk…). Allt annat är ett custom field du definierar en gång:

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": "Lojalitetsnivå" }'

Typer: text, tal, datum, boolean. När fältet är definierat finns det överallt — i mallvariabler ({{loyalty_tier}}), i segment-byggaren, på kontaktkortet i dashboarden och i CSV-import.

Skapa & uppdatera

# Skapa
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": "guld" }'

# Uppdatera (partiell — endast de fält du skickar ändras)
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": "platina" }'

Kontakter matchas på email/telefon, så import av samma person två gånger uppdaterar i stället för att duplicera.

CSV-import

Målgrupp → Kontakter → Importera (eller POST /v1/contacts/import). Ladda upp filen, mappa dina kolumner till fält (omappade kolumner kan bli nya custom fields på plats), välj mållistan och bekräfta. Import körs i bakgrunden med en förloppsindikator och en felrapport per rad — ett dåligt telefonnummer på rad 3 481 dödar inte de andra 50 000 raderna.

Listor vs. segment — när använder man vad

• En lista är statisk: kontakter är i den för att du satte dem där (import, formuläranmälan, manuell tillägg). Medlemskapet ändras bara när något lägger till/tar bort dem.
• Ett segment är levande: en regel ("spenderat > 500 € OCH inaktiv 30 dagar") som kontakter automatiskt flödar in och ut ur när deras data ändras.

Tumregel: listor för proveniens ("Vårmässa-leads 2026"), segment för tillstånd ("just nu i churn-risk"). Kampanjer och journeys accepterar båda.