Skip to main content
This guide sends your first email in four steps. Step three offers the same send over 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.