Terug naar overzichtTot nu toe verstuurde Lettermint elke e-mail direct nadat we hem binnenkregen. Wilde je hem later versturen, dan regelde je dat zelf. Een cron job die klaarstaande e-mails ophaalt, een queue met vertraging, of een reminder in je agenda om de campagne op tijd te versturen.
Wil je een e-mail inplannen met Lettermint, dan geef je voortaan gewoon een datum en tijd mee. Wij houden de e-mail vast en versturen hem op het moment dat jij hebt gekozen. Verandert er daarna iets? Dan verzet je het tijdstip of annuleer je de e-mail, zolang hij nog niet is verstuurd.
Scheduled emails
Met broadcast e-mails plan je een nieuwsbrief of campagne vooraf in. Je wekelijkse update gaat elke dinsdag om 10:00 uit, ook als je die maandag al klaar had. En voor een Black Friday campagne hoef je niet meer om middernacht achter je laptop te zitten.
Bij transactional e-mail plan je in op het moment dat je de informatie al hebt. Meldt iemand zich aan, dan kan de follow-up voor over drie dagen direct mee. Boekt iemand een afspraak, dan staat de herinnering voor de dag ervoor ook alvast klaar. Wordt de afspraak toch geannuleerd, dan haal je die herinnering weer weg.
Het tijdstip geef je mee bij het versturen. Dat kan in ISO 8601 (opent in een nieuw venster), in UTC of met een offset. Daarnaast ondersteunen we ook gewone Engelse tijden, zoals "tomorrow at 9am", "in 2 hours" of "Friday at 3pm ET". Inplannen kan vanaf 30 seconden tot 30 dagen vooruit.
Hoe werkt het
Je plant een e-mail in via de API of via SMTP. Gebruik je een van onze SDK's? Die ondersteunen het ook, dus je hoeft geen losse request te schrijven. Verstuur je een batch, dan kan elke e-mail daarin een eigen tijdstip krijgen. Handig als je één lijst hebt met ontvangers in verschillende tijdzones. Hieronder zie je hoe het via de API werkt.
curl -X POST "https://api.lettermint.co/v1/send" \
-H "x-lettermint-token: lm_project_token" \
-H "Content-Type: application/json" \
-d '{
"from": "hello@acme.com",
"to": ["recipient@example.com"],
"subject": "Appointment reminder",
"html": "<p>Your appointment starts tomorrow at 10:00.</p>",
"scheduled_at": "2026-09-17T09:00:00+02:00"
}'
Verstuur je via SMTP, dan voeg je de header X-LM-Scheduled-At toe aan je e-mail. Wij halen die header er weer af voordat de e-mail bij de ontvanger aankomt.
X-LM-Scheduled-At: 2026-09-17T09:00:00+02:00
Ingeplande e-mail verzetten of annuleren
Een ingeplande e-mail staat in je dashboard met de status Scheduled en de datum en tijd waarop hij verstuurd wordt. Je kunt hem daar verzetten of annuleren. Dat kan ook via de API, op basis van het message ID. Dat ID krijg je terug bij het versturen en staat ook in je dashboard en in de Team API.
Beschikbaar op Growth en Pro
Scheduled emails zit in de Growth en Pro abonnementen. Alle details, zoals de ondersteunde tijdnotaties en de batch-endpoint, vind je in de documentatie.