Brevo


Schemes	`brevo://`
Cargo feature	`service-brevo`
Service	https://www.brevo.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 brevo://.

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 Email	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):

brevo://abcd:user@example.com
brevo://abcd:user@example.com/newuser@example.com
brevo://abcd:user@example.com?format=text
brevo://abcd:user@example.com/newuser@example.com?cc=l2g@nuxref.com
brevo://abcd:user@example.com/newuser@example.com?to=l2g@nuxref.com
brevo://abcd:user@example.com/newuser@example.com?bcc=l2g@nuxref.com
brevo://abcd:user@example.com/newuser@example.com?reply=Bob%20<bob@example.com>
brevo://abcd:user@example.com/newuser@example.com?cc=l2g@nuxref.com&bcc=l2g@nuxref.com

Rejected URLs:

brevo://
brevo://:@/
brevo://abcd
brevo://abcd@host

Send one from the command line:

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

Notes

Brevo (brevo://): transactional e-mail through the Brevo API.

brevo://{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.