AWS Simple Email Service (SES)


Schemes	`ses://`
Cargo feature	`service-ses`
Service	https://aws.amazon.com/ses/
Body formats	`html` (first is the default)
Attachments	yes
Title length	250 characters
Body length	32,768 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{from_email}/{access_key_id}/{secret_access_key}/{region}/{targets}
{schema}://{from_email}/{access_key_id}/{secret_access_key}/{region}

{schema} is one of ses://.

URL tokens

Token	Meaning	Type	Required	Notes
`{access_key_id}`	Access Key ID	string	yes	secret
`{from_email}`	From Email	email	yes
`{region}`	Region	string	yes	must match `^[a-z]{2}-[a-z-]+?-[0-9]+$`
`{secret_access_key}`	Secret Access Key	string	yes	secret
`{targets}`	Target Emails	list	no	separated by `/`
`{token}`	Session Token	string	no	secret

Query parameters

Parameter	Meaning	Type	Notes
`access`	Access Key ID	string	sets `{access_key_id}`
`bcc`	Blind Carbon Copy	list	separated by `,` or space
`cc`	Carbon Copy	list	separated by `,` or space
`from`	From Email	email	sets `{from_email}`
`key`	Access Key ID	string	sets `{access_key_id}`
`name`	From Name	string
`region`	Region	string	sets `{region}`
`reply`	Reply To Email	string
`secret`	Secret Access Key	string	sets `{secret_access_key}`
`to`	Target Emails	list	sets `{targets}`
`token`	Session Token	string	sets `{token}`

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

ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2
ses://user:SESSIONTOKEN@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-east-1/
ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2/user2@example.com/Bob%20Smith%20%3Cbob@example.org%3E
ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2?format=text
ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2?token=TOK%2Bx%3D
ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2/a@example.com/b@example.com?cc=b@example.com
ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2/user2@example.com?reply=Rep%20Ly%20%3Crep@example.com%3E
ses://user@example.com/?key=T1JJ3T3L2&secret=A1BRTD4JD/TIiajkdnlazkcevi7FQ&region=US-WEST-2&from=other@example.net

Rejected URLs:

ses://
ses://:@/
ses://user@example.com/T1JJ3T3L2
ses://user@example.com/T1JJ3TD4JD/TIiajkdnlazk7FQ/

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'ses://user@example.com/T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcevi7FQ/us-west-2'

Notes

AWS Simple Email Service (ses://): SendRawEmail with a MIME message built by the shared mail module, signed with AWS SigV4.

Cc/Bcc recipients are sent in sorted order.