MailerSend


Schemes	`mailersend://`
Cargo feature	`service-mailersend`
Service	https://www.mailersend.com/
Body formats	`html`, `text` (first is the default)
Attachments	yes
Title length	250 characters
Body length	32,768 characters
Body lines	unlimited
Request throttle	200 ms between requests
Vendor URLs accepted	no

URL formats

{schema}://{apikey}:{from_email}
{schema}://{apikey}:{from_email}/{targets}

{schema} is one of mailersend://.

URL tokens

Token	Meaning	Type	Required	Notes
`{apikey}`	API Key	string	yes	secret; must match `^[a-zA-Z0-9._-]+$`
`{from_email}`	Source Email	email	yes
`{target_email}`	Target Email	email	no
`{targets}`	Targets	list	no	any of `target_email`; separated by `/`

Query parameters

Parameter	Meaning	Type	Notes
`bcc`	Blind Carbon Copy	list	separated by `,` or space
`cc`	Carbon Copy	list	separated by `,` or space
`reply`	Reply To	string
`to`	Targets	list	sets `{targets}`

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

mailersend://abcd:user@example.com
mailersend://abcd:user@example.com/newuser@example.com
mailersend://abcd:user@example.com?format=text
mailersend://abcd:user@example.com?cc=cc@example.com
mailersend://abcd:user@example.com?bcc=bcc@example.com
mailersend://abcd:user@example.com?to=extra@example.com
mailersend://abcd:user@example.com?reply=reply@example.com
mailersend://abcd:user@example.com/to@example.com?cc=x@example.com&bcc=x@example.com

Rejected URLs:

mailersend://
mailersend://:@/
mailersend://abcd
mailersend://abcd@host

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'mailersend://abcd:user@example.com'

Notes

MailerSend (mailersend://): e-mail through the MailerSend API.

mailersend://{apikey}:{from_user}@{from_domain}[/{to_email}...][?cc=..&bcc=..&reply=..&to=..]

Both an HTML and a plain-text part are sent; the one not given is converted from the other. Without targets the message goes to the sender.