Create email | MailtestAPI Docs

POST/v1/emailsAuth required

Create a captured email

Stores a new email body and metadata for the authenticated account.

Request body

CreateEmailRequestapplication/jsonrequired

Responses

201EmailResponse

Email stored successfully.

400ValidationErrorResponse

The request body did not pass validation.

401ErrorResponse

The API key is missing or invalid.

cURL example

curl -X POST https://api.mailtestapi.com/v1/emails \
  -H "Authorization: Bearer $MAILTEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "signup-check@mailtestapi.com",
    "sender": "sender@example.com",
    "subject": "Welcome aboard",
    "text": "Hello from MailtestAPI"
  }'

OpenAPI

This page is rendered from the live schema served by the production API.

View schema Production schema