emails
Send a custom email
Changed onSend 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).
post/v1/emails/send
Request
- Base URLhttps://public.api.paragraph.com/api
- URLhttps://public.api.paragraph.com/api/v1/emails/send
- AuthHTTP bearer
Request body
Response
Send request accepted
Changes
- warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status
- warning
- info
endpoint added
- info