Mit dem neuen /send/batch Endpoint sendest du mehrere E-Mails in einem einzigen API-Request. Praktisch, wenn deine Anwendung mehrere E-Mails gleichzeitig generiert, zum Beispiel nach der Verarbeitung eines Imports oder bei der Abarbeitung einer Queue.
Was ist Batch Email?
Anstatt für jede E-Mail einen separaten Request zu machen, bündelst du sie und sendest alles auf einmal. Du schickst ein Array mit bis zu 500 E-Mails an Lettermints /send/batch Endpoint.
Batch Email lässt sich auf verschiedene Arten nutzen. Versende komplett einzigartige E-Mails mit unterschiedlichen Empfängern, Betreffs und Inhalten. Oder sende dieselbe E-Mail an mehrere Empfänger gleichzeitig, wie einen Newsletter.
So vermeidest du, in kurzer Zeit Hunderte einzelner Requests an unsere API zu senden. Keine langen Schleifen mehr, die E-Mails einzeln versenden. Stattdessen bündelst du alles und sendest es in einem einzigen Request.
Wie funktioniert es?
Der Batch-Endpoint unterstützt dieselben Optionen wie unser Standard /send Endpoint für Transactional E-Mails. Du kannst also mit Anhängen, Tags, Routes und allen anderen Funktionen arbeiten, die du gewohnt bist.
Ein Beispiel mit 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."
}
]
}'
Du erhältst eine Response mit einer message_id für jede E-Mail. Damit kannst du den Status jeder E-Mail über das Dashboard oder über Webhooks verfolgen.
Verfügbarkeit
Der Batch-Endpoint ist für alle Nutzer verfügbar, einschließlich unserem kostenlosen Plan. Du kannst bis zu 500 E-Mails pro Request senden mit einer maximalen Payload von 25MB. Das schließt eventuelle Anhänge ein. Funktioniert sowohl für Transactional E-Mails als auch Broadcast E-Mails.
Sendest du mehr als 500 E-Mails? Teile sie dann in mehrere Batch-Requests auf. Die vollständige Dokumentation findest du auf docs.lettermint.co.