Quickstart

Add a domain and send your first email in a few minutes.

1. Add a domain

In the dashboard, go to Domains and add the domain or subdomain you want to send and receive from. We recommend a subdomain such as mail.yourdomain.com to keep transactional reputation separate from your main domain.

2. Add the DNS records

The dashboard shows the exact DKIM, SPF and MX records for your domain. Add them at your DNS provider, then click verify. Most providers propagate changes within minutes, though it can occasionally take longer.

3. Create an API key

In API keys, create a new key and store it somewhere safe. It is shown once, in full, at creation time, and never again after that.

4. Send an email

curl -X POST https://<your-host>/api/emails \
  -H "Authorization: Bearer gs_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"hi@yourdomain.com","to":"user@example.com",
       "subject":"Hello","html":"<strong>it works</strong>"}'

Until your domain is verified, new accounts can only send to their own account email, as a sandbox. Once verification succeeds, you can send to any address.

5. Receive email

Point the MX record of your domain at your Geserd host and add a webhook endpoint in the dashboard. Incoming mail arrives at your endpoint as an email.received event, described in the API reference.