Laatste updates

Verstuur meerdere e-mails tegelijk met batch email

Gepubliceerd op:

Met het nieuwe /send/batch endpoint verstuur je meerdere e-mails in één API request. Handig wanneer je applicatie meerdere e-mails tegelijk genereert, bijvoorbeeld na het verwerken van een import of bij het afhandelen van een queue.

Wat is batch email?

In plaats van voor elke e-mail een apart request te doen, bundel je ze en verstuur je alles tegelijk. Je stuurt een array met maximaal 500 e-mails naar Lettermint's /send/batch endpoint.

Batch email is op verschillende manieren te gebruiken. Verstuur volledig unieke e-mails met verschillende ontvangers, onderwerpen en inhoud. Of stuur dezelfde e-mail naar meerdere ontvangers in één keer, zoals een nieuwsbrief.

Zo voorkom je dat je in korte tijd honderden losse requests naar onze API stuurt. Geen lange loops meer die één voor één e-mails versturen. In plaats daarvan bundel je alles en verstuur je het in één request.

Hoe werkt het?

Het batch endpoint ondersteunt dezelfde opties als ons standaard /send endpoint voor transactional e-mails. Je kunt dus werken met bijlagen, tags, routes en alle andere functies die je gewend bent.

Een voorbeeld met curl:

          curl --request POST \
  --url https://api.lettermint.co/v1/send/batch \
  --header 'x-lettermint-token: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "messages": [
      {
        "from": "shop@example.com",
        "to": "customer1@example.com",
        "subject": "Your order is ready",
        "html": "Your order has been shipped."
      },
      {
        "from": "shop@example.com",
        "to": "customer2@example.com",
        "subject": "Your order is ready",
        "html": "Your order has been shipped."
      }
    ]
  }'

        

Je ontvangt een response met voor elke e-mail een message_id. Hiermee kun je de status van elke e-mail volgen via het dashboard of via webhooks.

Beschikbaarheid

Het batch endpoint is beschikbaar voor alle gebruikers, inclusief ons free plan. Je kunt tot 500 e-mails per request versturen met een maximale payload van 25MB. Dit is inclusief eventuele bijlagen. Werkt voor zowel transactional e-mails als broadcast e-mails.

Verstuur je meer dan 500 e-mails? Splits ze dan op in meerdere batch requests. Bekijk de volledige documentatie op docs.lettermint.co.