Hurtigstart: send din første melding

Denne guiden sender din første melding på omtrent fem minutter.

1. Hent API-nøkkelen din

Logg inn i dashbordet, åpne Innstillinger → API-nøkler, og opprett en nøkkel. Den autentiserer hver forespørsel du sender og bør aldri eksponeres i en nettleser eller mobilapp — kall den fra din egen backend.

Bekreftelseslenken er det som oppretter kontoen. POST /v1/auth/signup svarer 202 og oppretter ingenting: kontoen — og dens første API-nøkkel — blir til når du følger lenken WeZend sender deg. Registrer med en jobb-e-postadresse; private postkasser (Gmail, Outlook, Yahoo, Proton) og midlertidige adresser avvises, og firmafeltene er påkrevd — POST /v1/auth/signup/lookup-vat fyller dem fra MVA-registeret. Mistet lenken? POST /v1/auth/send-verify-email sender en ny, gyldig i 24 timer. En eldre konto som aldri bekreftet adressen sin kan ikke sende før det skjer: de meldingene opprettes med status suppressed og en begrunnelse, ikke i kø.

2. Send en melding

curl https://api.wezend.com/v1/messages/send \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+4512345678",
    "channel": "sms",
    "message": "Hei fra WeZend"
  }'

Eksemplet sender bevisst uten et sender-felt, slik at meldingen bruker kontoens standardavsender — det fungerer på en ny konto så snart e-postadressen er bekreftet. En egen sender (merkevarenavnet ditt) må først godkjennes under Innstillinger → Avsender-ID-er; en ikke-godkjent verdi avvises med 403.

Et vellykket kall returnerer 201 med meldingsposten:

{
  "message_id": "3fa1e2c0-...",
  "status": "queued",
  "channel": "sms",
  "to": "+4512345678",
  "cost": 0.045,
  "currency": "EUR",
  "created_at": "2026-07-08T10:00:00.000Z"
}

3. Sjekk leveringen

Poll GET /v1/messages/:message_id, eller — bedre ved reelt volum — send med en webhook_url i selve forespørselen og motta leveringsoppdateringer i sanntid. Se Webhooks.

Før den første ekte e-posten: verifiser domenet

Utsendelsen over går ut under WeZends delte standardavsender. For å sende som deres eget domene — og holde dere utenfor søppelposten — legg det til først under Innstillinger → Domener (GET /v1/account/email-domains). WeZend genererer de nøyaktige postene for kontoen deres: et SPF-include:, et DKIM-CNAME under WeZends egen selektor, og en anbefalt DMARC som starter på p=none.

Publiser DKIM-posten under selektoren WeZend gir dere — ikke en e-postverten deres allerede bruker til sin egen post. Det er ulike nøkler, og bare WeZends selektor matcher signaturen vi påfører. Kall deretter POST /v1/account/email-domains/:id/verify; checks-objektet sier per post hva som gikk gjennom og, hvis ikke, hvorfor. Bli på p=none til DKIM verifiserer, og stram deretter. Full gjennomgang: E-post: domener, DNS & utsending.

Hva som må aktiveres

Ikke alt er selvbetjening, og det er bedre å vite nå enn å feilsøke det senere.

Du trenger ingen liste for å se det virke. Dashbordets første steg sender én ekte melding til adressen du bekreftet ved registreringen — ett klikk, ingen import, ingen kontakter. Den går gjennom den vanlige sendeveien (POST /v1/onboarding/send-test), så den kvoteteller, rutes, avregnes og havner på tidslinjen akkurat som produksjonstrafikk: det du ser, er det en kunde ville få — ikke en simulering. Import av kontakter kan vente til noe synlig har virket — og det er rekkefølgen som viser seg å betyde noe, for de som sender i det hele tatt, sender innen timer etter registreringen.

Neste steg

• Autentisering — API-nøkler kontra dashbord-sesjoner
• Sende meldinger — alle felt /v1/messages/send godtar, og kanal-fallback
• Rate limits — de reelle, gjeldende grensene per endepunkt