---
title: "Create a new deliverability test"
method: POST
path: "/test"
tags: ["tests"]
---

# Create a new deliverability test

`POST /test`

Generates a unique test email address for sending test emails. No database record is created until an email is received.

## Response `201`

Test email address generated successfully

- TestResponse
  - `id` string, required — Unique test identifier (base32-encoded with hyphens)
  - `email` string, email, required
  - `status` 'pending', required
  - `message` string

## Other responses

- `500` — Internal server error

## Changes

- **2025-10-20** `84d494a8a241` — 1 breaking, 1 info
  - the `id` response's property format changed from `uuid` to no format for status `201`
  - the `id` response's property pattern `^[a-z0-9-]+$` was added for the status `201`
- **2025-10-15** `0178a1195e1a` — 2 breaking, 7 info
  - the response's body type changed from no type to `object` for status `201`
  - the response's body type changed from no type to `object` for status `500`
  - added the optional property `details` to the response with the `500` status
  - added the optional property `message` to the response with the `201` status
  - …5 more

[Change history](https://skmtc.dev/happydomain/apis/happydeliver-api/changes/test/post.md)

---

[API](https://skmtc.dev/happydomain/apis/happydeliver-api.md) · [All operations](https://skmtc.dev/happydomain/apis/happydeliver-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/happydomain/happydeliver-api/revisions/2ff707f6d044/schema)