SendPulse
| Schemes | sendpulse:// |
| Cargo feature | service-sendpulse |
| Service | https://sendpulse.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}://{user}@{host}/{client_secret}/
{schema}://{user}@{host}/{client_id}/{client_secret}/{targets}
{schema} is one of sendpulse://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{client_id} | Client ID | string | yes | secret; must match ^[A-Z0-9._-]+$ | |
{client_secret} | Client Secret | string | yes | secret; must match ^[A-Z0-9._-]+$ | |
{host} | Domain | string | yes | ||
{target_email} | Target Email | no | |||
{targets} | Targets | list | no | any of target_email; separated by / | |
{user} | User Name | string | yes |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
bcc | Blind Carbon Copy | list | separated by , or space | |
cc | Carbon Copy | list | separated by , or space | |
from | From Email | string | ||
id | Client ID | string | sets {client_id} | |
secret | Client Secret | string | sets {client_secret} | |
template | Template ID | int | ||
to | Targets | list | sets {targets} |
Prefixed parameters:
+name=value: Template Data
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):
sendpulse://user@example.com/client_id/cs1/
sendpulse://user@example.com/client_id/cs17/a@example.com/b@example.com
sendpulse://example.com/client_id/cs1/?user=chris
sendpulse://user@example.com/client_id/cs6/?to=invalid
sendpulse://chris@example.com/client_id/cs1/?from=Chris
sendpulse://user@example.com/client_id/cs1/?format=text
sendpulse://user@example.com/client_id/cs1/?template=123
sendpulse://user@example.com/client_id/cs2/?bcc=l2g@nuxref.com
Rejected URLs:
sendpulse://
sendpulse://:@/
sendpulse://abcd
sendpulse://abcd@host.com
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'sendpulse://user@example.com/client_id/cs1/'
Notes
SendPulse (sendpulse://): e-mail through the SendPulse API.
sendpulse://{user}@{domain}/{client_id}/{client_secret}[/{to_email}...] sendpulse://{to_domain}?id=..&secret=..&from=.. (?user= also accepted) ?from=..&cc=..&bcc=..&to=..&template={id}&+var=value
An OAuth access token (POST /oauth/access_token, client credentials) is obtained when the persistent store has none and kept there until it expires (expires_in minus 10 s, at most an hour). One e-mail is posted per target; a 401 triggers one re-login and retry.