Verzenden
E-mail verzenden
Verstuur veilig transactionele berichten, batches, antwoorden, bijlagen en gehoste templates.
Inhoud van het bericht
Geef een from-identiteit op een geverifieerd domein van de workspace op, minstens één to-ontvanger, en HTML, tekst of één gepubliceerde gehoste template. Bij een verzending met ruwe inhoud mag je subject weglaten; het onderwerp is dan leeg. SendHQ genereert zo nodig een tekstalternatief uit de HTML, maar een zelfgeschreven alternatief is betrouwbaarder.
Ontvangers en credits
Een bericht mag in totaal maximaal 100 To-, Cc- en Bcc-bestemmingen bevatten. Elke bestemming verbruikt één credit voor aflevering bij een ontvanger. Dubbele genormaliseerde ontvangersadressen worden één keer tegen de suppressielijst gecontroleerd, maar elke bestemming telt nog steeds mee voor de berichtlimieten.
Veilige retries
Stuur bij losse en batchverzendingen een stabiele Idempotency-Key van maximaal 200 tekens mee. Hergebruik je een sleutel met een identieke JSON-payload, dan wordt de opgeslagen respons opnieuw afgespeeld en krijg je Idempotent-Replayed: true erbij. Wijzig je onder dezelfde sleutel een ontvanger, inhoud, header of templatedata, dan krijg je 409; een gelijktijdig request met die sleutel geeft ook 409 zolang het eerste nog loopt.
Batchverzending
POST /emails/batch accepteert maximaal 100 berichtobjecten en geeft voor elke positie een resultaat terug. Gebruik aparte berichtobjecten voor gepersonaliseerde templatedata in plaats van één gepersonaliseerde template naar meerdere ontvangers te sturen.
Antwoorden en threads
Stel reply_to_email_id in wanneer je antwoordt. SendHQ leidt Message-ID, In-Reply-To, References en het bestaande thread-ID af. Haal het volledige gesprek op met GET /threads/:id.