Skapa eller uppdatera kund

PUT/api/v1/stores/{store_id}/customers/{customer_id}

Skapar kunden med butikens id, eller uppdaterar den. Ordrar och korgar gör det här själva med sin kund.

En kund blir aldrig en kontakt och får aldrig utskick för att hen har handlat. Har kunden samtyckt till nyhetsbrev: anmäl hen till en lista med POST /lists/{id}/members, med beviset för samtycket.

Fält du utelämnar behålls; null tömmer dem. Svarar 201 när kunden skapades och 200 när den uppdaterades.

Kunder och samtycke →

Behörighet

ecommerce:write Ändra e-handel – personen bakom nyckeln måste vara redaktör eller högre.

Sökvägsparametrar

store_idstringkrävs: Butikens id, som ni väljer.
customer_idstringkrävs: Kundens id i er butik.

Kropp

JSON, Content-Type: application/json. Okända fält ger 422.

emailstringkrävs: Kundens e-postadress.högst 254 tecken
first_namestring | null: Förnamn.högst 100 tecken
last_namestring | null: Efternamn.högst 100 tecken
companystring | null: Företag.högst 200 tecken

Göra om anropet

PUT skapar eller uppdaterar på butikens egna id: samma anrop två gånger ger samma resultat, så det kan alltid göras om. Batch och idempotens

Svar

200 Kunden (201 om den skapades).

idstringkrävs
emailstringkrävs
first_namestring | nullkrävs
last_namestring | nullkrävs
companystring | nullkrävs
contact_idstring | nullkrävs: Arbetsytans kontakt med samma adress, om det finns en. En kund blir aldrig en kontakt av sig själv.
orders_countintegerkrävs: Betalda ordrar.
total_spentnumberkrävs: Summan av de betalda ordrarna.
last_order_atstring (tid, ISO 8601) | nullkrävs: Senaste betalda ordern.
created_atstring (tid, ISO 8601)krävs: När kunden skickades in första gången.
updated_atstring (tid, ISO 8601)krävs: När kunden senast ändrades.

Fel

400: bad_request
401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
404: not_found
415: unsupported_media_type
422: validation_failed
429: rate_limited
500: internal_error

Anrop

curl -X PUT 'https://newsletter.qrona.se/api/v1/stores/butik-se/customers/1042' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"anna@example.se","first_name":"Anna","last_name":"Svensson"}'

Svar 200

{
  "id": "1042",
  "email": "anna@example.se",
  "first_name": "Anna",
  "last_name": "Svensson",
  "company": null,
  "contact_id": "877",
  "orders_count": 3,
  "total_spent": 1847,
  "last_order_at": "2026-10-12T14:03:00.000Z",
  "created_at": "2026-03-02T09:00:00.000Z",
  "updated_at": "2026-10-12T14:03:00.000Z"
}