Aan de slag

Quickstart

Van nul tot je eerste verzonden e-mail in minder dan vijf minuten. Je hebt een eigen domein nodig waar je DNS-records op kunt instellen.

Stap 1: Account aanmaken

Maak een gratis account aan op wesender.nl. De eerste 3.000 e-mails per maand zijn gratis, geen creditcard nodig.

Gratis account aanmaken →

Stap 2: Verzenddomein toevoegen

Ga naar Domeinen in je dashboard en voeg het (sub)domein toe waarvandaan je wil verzenden, bijv. mail.joudomein.nl. Je krijgt drie DNS-records terug:

Type	Naam	Doel
TXT	`mail.joudomein.nl`	SPF: vertelt ontvangende servers dat Wesender mag verzenden.
TXT	`wesender._domainkey.mail.joudomein.nl`	DKIM: digitale handtekening op elke e-mail.
TXT	`_dmarc.mail.joudomein.nl`	DMARC: beleid bij misbruik van je domein.

Stel de records in bij je domeinregistrar of DNS-provider. DNS-wijzigingen kunnen tot 24 uur duren, maar propageren vaak al binnen enkele minuten. Wesender controleert elke 5 minuten automatisch of de records kloppen.

Wil je de verificatie direct starten? Zie Domein instellen voor een gedetailleerde handleiding per registrar.

Stap 3: API-key aanmaken

Ga naar API-keys in je dashboard en maak een nieuwe key aan. Bewaar de key direct op een veilige plek, hij wordt maar één keer volledig getoond.

Sla hem op als omgevingsvariabele in je project:

Omgevingsvariabele

WS_API_KEY=ws_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Stap 4: Eerste e-mail versturen

Vervang noreply@joudomein.nl met je geverifieerde afzenderadres en jij@voorbeeld.nl met een eigen e-mailadres om de mail te ontvangen.

send-email.ts

curl -X POST https://api.wesender.nl/emails \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from":    "noreply@joudomein.nl",
    "to":      ["jij@voorbeeld.nl"],
    "subject": "Hallo van Wesender",
    "html":    "<h1>Het werkt!</h1><p>Je eerste mail via Wesender.</p>"
  }'

import { Wesender } from "@wesender/node"

const ws = new Wesender(process.env.WS_API_KEY!)

const { id } = await ws.emails.send({
  from:    "noreply@joudomein.nl",
  to:      ["jij@voorbeeld.nl"],
  subject: "Hallo van Wesender",
  html:    "<h1>Het werkt!</h1><p>Je eerste mail via Wesender.</p>",
})

console.log("Verstuurd:", id)

Bij succes antwoordt de API met 201 Created:

201 Created

HTTP/1.1 201 Created

{
  "id":     "em_01hwxxxxxxxxxxxxxx",
  "object": "email"
}

Node.js SDK installeren