curl, an SDK, and the CLI; pick whichever you will actually build on.
1
Add and verify a sending domain
In the dashboard, add the domain you want to send from and publish the DNS records mailkube generates for it (SPF, DKIM, DMARC). Sending is allowed once the domain is verified. See Domains for the full process.
2
Create an API key
Open API keys and create a key for your domain. Copy the key immediately. It is shown only once.
3
Send an email
Swap in your key and addresses, then run one of these:Install first if you picked one of the last two:
pip install mailkube, or the CLI installer. Add --dry-run to the CLI command to print the request without spending quota.4
Check the response
A successful request returns
200 OK with the message id and its RFC Message-ID:The
from address must use a domain you’ve verified on your account. Sending from an unverified domain is rejected.Next steps
- Sending your first email covers attachments, plain-text bodies, custom headers, and error handling.
- Authentication covers the API key format and how to keep secrets safe.
- Errors explains the error envelope and what each code means.
- SDKs and the CLI cover the other two ways in, including webhook receivers.
- SMTP relays the same mail from software that already speaks it.