Testmail · GraphQL Specification

Testmail.app GraphQL API

The Testmail.app GraphQL API provides a full-featured interface for querying test emails from programmable inboxes. Emails are routed to addresses in the format `{namespace}.{tag}@inbox.testmail.app`, where a namespace is a unique identifier tied to an API key and a tag is a freely chosen sub-inbox label. The API exposes a single `inbox` query that retrieves emails matching a namespace and optional tag or tag prefix, returning a rich `Email` object with parsed headers, body content (HTML and plaintext), attachments, SPF/DKIM authentication results, and spam scoring via SpamAssassin.

Documentation Endpoint View on GitHub Email TestingDeveloper ToolsAPI TestingGraphQLREST APICI/CDQA AutomationProgrammable InboxesGraphQL

Overview

Testmail.app GraphQL API is a GraphQL API specification published by Testmail on the APIs.io network.

The Testmail.app GraphQL API provides a full-featured interface for querying test emails from programmable inboxes. Emails are routed to addresses in the format {namespace}.{tag}@inbox.testmail.app, where a namespace is a unique identifier tied to an API key and a tag is a freely chosen sub-inbox label. The API exposes a single inbox query that retrieves emails matching a namespace and optional tag or tag prefix, returning a rich Email object with parsed headers, body content (HTML and plaintext), attachments, SPF/DKIM authentication results, and spam scoring via SpamAssassin.

The GraphQL endpoint is available at https://api.testmail.app/api/graphql. documentation is published at https://testmail.app/docs/.

The specification includes 2 reference links.

Tagged areas include Email Testing, Developer Tools, API Testing, REST API, and CI/CD.

Endpoint

https://api.testmail.app/api/graphql

References

Related API Specs

Testmail GraphQL API (OpenAPI) Testmail Inbox API (OpenAPI)
Back to Testmail · All GraphQL Specs · GitHub

Work with this as data

Every GraphQL schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for graphql

4 MCP tools reach this
  • find_graphqlBrowse and filter every GraphQL schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This GraphQL schema
curl "https://apis.io/api/v1/graphql/testmail-app-graphql"
All graphql
curl "https://apis.io/api/v1/graphql?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.