Send a custom email
Send an email from your publication to a list of recipient addresses.
Eligibility:
- Publications must be approved by Paragraph before they can send custom emails. Ineligible publications receive a 403. Eligibility is managed by Paragraph and is not user-configurable.
Per-recipient filtering:
- Malformed addresses and known disposable domains are skipped.
- Addresses that previously unsubscribed from this publication are skipped as suppressed.
- Skipped recipients are returned in the response; nothing else is delivered to them.
Delivery:
- body is treated as Markdown and rendered to HTML server-side.
- Each recipient receives the email individually (not as a BCC blast) with a mandatory unsubscribe footer.
- Sends are queued asynchronously; a 200 response means recipients were accepted, not delivered.
Caps:
- Maximum of 10,000 addresses per call (request-level sanity check).
Request body
Response
Send request accepted
Changes
Changed in 2 of the 61 revisions of this API.61
- ●
removed the optional property
errorfrom the response with the400statusresponse-optional-property-removed
- ●
removed the optional property
errorfrom the response with the401statusresponse-optional-property-removed
- ●
removed the optional property
errorfrom the response with the403statusresponse-optional-property-removed
- ●
removed the optional property
errorfrom the response with the404statusresponse-optional-property-removed
- ●
removed the optional property
errorfrom the response with the500statusresponse-optional-property-removed
- ●
removed the optional property
errorfrom the response with the503statusresponse-optional-property-removed
- ●
- ○
endpoint added
endpoint-added
- ○