Send email with curl.

Set your key

Create a key under API keys in the dashboard. It is shown once; keep it in an environment variable on your server.

1export MAILTRUSS_API_KEY=ms_live_…

Send an email

This sends one message and passes an idempotency key, so repeating the request can never deliver it twice. Send an Idempotency-Key header. The same key never sends twice, so you can repeat the request after a timeout or a 5xx.

1curl -X POST https://mailtruss.com/api/v1/emails \
2  -H "Authorization: Bearer $MAILTRUSS_API_KEY" \
3  -H "Idempotency-Key: order-1042-receipt" \
4  -H "Content-Type: application/json" \
5  -d '{ "from": "hello@yourdomain.com", "to": "user@example.com", "subject": "Hi", "text": "Hello" }'

The response is { "id": "…" }. Fetch the message's delivery timeline, what each event proves, and a diagnosis if something went wrong:

1curl https://mailtruss.com/api/v1/emails/EMAIL_ID/events \
2  -H "Authorization: Bearer $MAILTRUSS_API_KEY"

More on what you can put in a message (cc, bcc, attachments, tags, templates, scheduling) is under Sending.

Handle errors

Errors are JSON with a name and a message, and every response carries an x-request-id header you can search in the dashboard's API logs. Every error name, with its cause and fix, is in the error catalogue.

Other languages

• Node.js
• Python
• Go
• PHP
• Ruby
• Java
• .NET