API reference

The MailMoo API is a JSON API over HTTPS. Every request authenticates with an API key, and what a key can reach is decided by the permissions granted to it.

Getting started

1. Create an API key with the least access your integration needs.

2. Send it as a bearer token on every request:

   Authorization: Bearer sk_live_YOUR_KEY

3. Call an endpoint. Everything available is listed under Endpoints in the sidebar.

If a term in a request or response is unfamiliar, Concepts defines the objects the API operates on and how they relate.

Base URL

https://app.mailmoo.io/api/v3

Permissions and errors

A key can only reach endpoints covered by its permissions. Calling one it lacks returns 403 naming the permission required, so the fix is usually to grant that permission rather than to create a new key. See API keys.

Working with an AI assistant

If you want an assistant to use MailMoo directly rather than writing code against it, the MCP server exposes the same operations as tools, authenticated with the same key.