---
title: "Send an email delivery connection test"
method: POST
path: "/v1/email-delivery-connections/{connection_id}/test"
tags: ["Email Delivery Connections"]
---

# Send an email delivery connection test

`POST /v1/email-delivery-connections/{connection_id}/test`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/email-delivery-connections/{connection_id}/test`
- Auth: HTTP bearer

Sends one real test email through the saved connection. This is the definitive check when a send-only provider key cannot be inspected.

## Path parameters

- `connection_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- EmailDeliveryConnectionTestRequest
  - `to` string, email, required

## Response `200`

Test email sent.

- object
  - `data` object, required
    - `connection_id` string, required
    - `recipient` string, email, required
    - `status` 'sent', required
    - `sent_at` string, date-time, required
    - `provider_message_ids` string[]: Provider acceptance IDs in sent-message order; null when unavailable. These are not delivery or inbox receipts.

## Other responses

- `400`: The recipient is invalid or the test send failed.
- `429`: Too many test emails were requested.

---

[API](https://skmtc.dev/mailrith/apis/mailrith-api.md) · [All operations](https://skmtc.dev/mailrith/apis/mailrith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailrith/apis/mailrith-api/revisions/41f09536f2da?raw)