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 JSON API (OpenAPI) Testmail GraphQL API (OpenAPI)
Back to Testmail · All GraphQL Specs · GitHub