SMTP2Go
| Schemes | smtp2go:// |
| Cargo feature | service-smtp2go |
| Service | https://www.smtp2go.com/ |
| Body formats | html (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}://{user}@{host}/{apikey}/
{schema}://{user}@{host}/{apikey}/{targets}
{schema} is one of smtp2go://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{apikey} | API Key | string | yes | secret | |
{host} | Domain | string | yes | ||
{targets} | Target Emails | list | no | separated by / | |
{user} | User Name | string | yes |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
batch | Batch Mode | bool | no | |
bcc | Blind Carbon Copy | list | separated by , or space | |
cc | Carbon Copy | list | separated by , or space | |
name | From Name | string | ||
to | Target Emails | list | sets {targets} |
Prefixed parameters:
+name=value: Email Header
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):
smtp2go://user@localhost.localdomain/key/test@example.com
smtp2go://user@localhost.localdomain/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbb-cccccccc
smtp2go://no-reply@example.com/key/user1@example.com/User2:user2@example.com?batch=yes
smtp2go://user@localhost.localdomain/key?name=Jo%20Doe
smtp2go://user@localhost.localdomain/key/Bob:bob@example.com?name=J%C3%B6rg
smtp2go://user@localhost.localdomain/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbb-cccccccc?format=markdown
smtp2go://user@localhost.localdomain/key?to=test@example.com
smtp2go://user@localhost.localdomain/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbb-cccccccc?+X-Customer-Campaign-ID=Mercurio
Rejected URLs:
smtp2go://
smtp2go://:@/
smtp2go://user@localhost.localdomain
smtp2go://localhost.localdomain/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-bbbbbbbb-cccccccc
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'smtp2go://user@localhost.localdomain/key/test@example.com'
Notes
SMTP2Go (smtp2go://): e-mail through the SMTP2Go API.
smtp2go://{user}@{domain}/{apikey}[/{to_email}...] ?name=..&cc=..&bcc=..&batch=yes&to=..&+Header=v
+key=value entries become custom e-mail headers. Without targets the message goes to the sender.