Introduction

Geserd is an email API for sending and receiving. Send transactional email from your own verified domain, accept inbound mail sent to it, and reply from the same address, all through one HTTP API.

Geserd is in active development. This documentation describes the API as designed and some endpoints may not be live yet. The status page and changelog track what has actually shipped.

What you can do

Verify a domain you own, then send email from any address on it, receive mail sent to that domain, get real-time events on a webhook for deliveries and inbound messages, and inspect every message and every API request in the dashboard.

Base URL

https://<your-host>/api

Replace <your-host> with the domain of your Geserd deployment. Every path in this documentation is relative to this base URL.

Authentication

Create an API key in the dashboard and send it as a bearer token on every request. Keys are shown once at creation and stored on our side only as a hash, so keep a copy somewhere safe.

Header

Authorization: Bearer gs_xxxxxxxx

Errors

Errors are returned as JSON with an error field and a matching HTTP status code. See the Errors page for the full list of codes and what causes each one.

Next steps

Follow the Quickstart to add a domain and send your first email in a few minutes.