API-referentie

Batch versturen

Stuur tot 50 e-mails in één aanroep. Elke e-mail wordt onafhankelijk verwerkt. Een fout in één bericht laat de rest ongemoeid.

POST https://api.wesender.nl/emails/batch

Parameters

Stuur een JSON-array van e-mailobjecten. Elk object heeft dezelfde velden als POST /emails. Maximum 50 objecten per aanroep.

Veld	Type	Vereist	Beschrijving
from	string	Ja	Afzender per e-mail. Geverifieerd domein verplicht.
to	string \| string[]	Ja	Ontvanger(s). Maximaal 50 per e-mail.
subject	string	Ja	Onderwerp.
html	string	Nee	HTML-body. Minimaal html of text verplicht.
text	string	Nee	Platte tekst fallback.

Voorbeeld

curl -X POST https://api.wesender.nl/emails/batch \
  -H "Authorization: Bearer $WS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "from":    "noreply@joudomein.nl",
      "to":      ["alice@voorbeeld.nl"],
      "subject": "Je wekelijkse rapport",
      "html":    "<p>Hoi Alice, hier is je rapport.</p>"
    },
    {
      "from":    "noreply@joudomein.nl",
      "to":      ["bob@voorbeeld.nl"],
      "subject": "Je wekelijkse rapport",
      "html":    "<p>Hoi Bob, hier is je rapport.</p>"
    }
  ]'

import { Wesender } from "@wesender/node"

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

const results = await ws.emails.sendBatch([
  {
    from:    "noreply@joudomein.nl",
    to:      ["alice@voorbeeld.nl"],
    subject: "Je wekelijkse rapport",
    html:    "<p>Hoi Alice, hier is je rapport.</p>",
  },
  {
    from:    "noreply@joudomein.nl",
    to:      ["bob@voorbeeld.nl"],
    subject: "Je wekelijkse rapport",
    html:    "<p>Hoi Bob, hier is je rapport.</p>",
  },
])

// results[0].id, results[1].id, ...

Respons

Geeft een array terug met één object per e-mail, in dezelfde volgorde als het verzoek.

201 Created

HTTP/1.1 201 Created

[
  { "id": "em_01hwaaaaaaaaaa", "object": "email" },
  { "id": "em_01hwbbbbbbbbbb", "object": "email" }
]

Limieten

Maximum 50 e-mails per aanroep.
Elke e-mail telt apart mee voor je maandlimiet.
Bijlagen zijn toegestaan maar verhogen de verwerkingstijd.

Foutcodes