API Reference
Mailtarget exposes HTTP APIs for sending email, managing account resources, reading analytics, and operating email infrastructure. Requests use JSON over HTTPS and authenticate with an API key in the Authorization header.
Base URLs
| Surface | Base URL | Use for |
|---|---|---|
| Transmission API | https://transmission.mailtarget.co/v1 | Sending email through /layang/transmissions. |
| Dashboard API | https://apiconfig.mailtarget.co/v1 | API keys, sending domains, templates, sub-accounts, permissions, and account data. |
| Analytics API | https://apiconfig.mailtarget.co/v1 | Summary analytics and transmission event lookups. |
Start here
- Create an API key with the smallest permission scope your workload needs.
- Store the key in a server-side secret store.
- Send one message through the API Quickstart.
- Use Webhooks to reconcile delivery events.
- Add retry handling from Errors and Rate Limits.
Common references
Generated operation reference
The generated reference pages below are produced from openapi.yaml. If a generated page title or field description looks wrong, fix the source OpenAPI description first, then run npm run gen:api.