Appearance

OpenAPI Spec ​

The full OpenAPI 3.0 specification is available for download and import into your favorite API client.

Interactive Documentation ​

Browse the interactive API reference powered by Scalar:

Open API Reference →

Download Spec ​

bash
curl -O https://api.mail.td/api/docs/openapi.yaml

Or download directly: openapi.yaml

Official SDKs ​

We provide official SDKs for popular languages — see the SDKs page for installation and usage.

LanguagePackageRepository
Node.js / TypeScriptnpm install mailtdmailtd/mailtd-node
Pythonpip install mailtdmailtd/mailtd-python
Gogo get github.com/mailtd/mailtd-gomailtd/mailtd-go

Import into API Clients ​

Postman ​

  1. Open Postman → Import → Link
  2. Paste: https://api.mail.td/api/docs/openapi.yaml
  3. Click Import

Insomnia ​

  1. Open Insomnia → Import/Export → Import Data
  2. Choose From URL
  3. Paste: https://api.mail.td/api/docs/openapi.yaml

Bruno ​

  1. Open Bruno → Collection → Import
  2. Select OpenAPI → paste the URL or downloaded file

Generate Custom Client ​

If you need a language not covered by the official SDKs, use OpenAPI Generator:

bash
# Install
npm install @openapitools/openapi-generator-cli -g

# Generate (example: Ruby)
openapi-generator-cli generate \
  -i https://api.mail.td/api/docs/openapi.yaml \
  -g ruby \
  -o ./mailtd-ruby

Mail.td API Documentation