Skapa eller uppdatera butik

PUT/api/v1/stores/{store_id}

Skapar butiken med ert id, eller uppdaterar den. Det första anropet för en webbutik.

Svarar 201 när butiken skapades och 200 när den uppdaterades. Butikens id väljer ni själva (t.ex. butik-se) och det ändras aldrig: allt annat i e-handeln ligger under /stores/{store_id}.

Med domain får länkar till butiken i arbetsytans utskick parametern qn_cid=<kampanjens id>. Spara den i butiken när kunden kommer och skicka den som campaign_id på ordern, så räknas ordern som kampanjens intäkt.

Guide: e-handel →

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.

Kropp

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

namestringkrävs: Butikens namn, som det visas i appen.minst 1 tecken · högst 200 tecken
domainstring | null: Butikens domän, t.ex. butik.se. Länkar dit (och till underdomäner) i arbetsytans utskick får qn_cid=<kampanjens id>, som butiken skickar tillbaka som campaign_id på ordern.högst 253 tecken
currencystringkrävs: Butikens valuta (ISO 4217). Ordrar och korgar utan egen valuta får den.

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 Butiken (201 om den skapades).

idstringkrävs: Butikens id.
namestringkrävs
domainstring | nullkrävs
currencystringkrävs
countsobjectkrävs: Hur mycket butiken har skickat in.
counts.customersintegerkrävs
counts.productsintegerkrävs
counts.ordersintegerkrävs
counts.cartsintegerkrävs
created_atstring (tid, ISO 8601)krävs: När butiken skapades.
updated_atstring (tid, ISO 8601)krävs: När butiken 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
409: limit_reached
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' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Exempelbutiken","domain":"butik.se","currency":"SEK"}'

Svar 200

{
  "id": "butik-se",
  "name": "Exempelbutiken",
  "domain": "butik.se",
  "currency": "SEK",
  "counts": {
    "customers": 1840,
    "products": 312,
    "orders": 5120,
    "carts": 14
  },
  "created_at": "2026-10-19T08:30:00.000Z",
  "updated_at": "2026-10-19T08:30:00.000Z"
}