---
title: "Send a broadcast test email"
method: POST
path: "/v1/broadcasts/{broadcast_id}/test"
tags: ["Broadcasts"]
---

# Send a broadcast test email

`POST /v1/broadcasts/{broadcast_id}/test`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/broadcasts/{broadcast_id}/test`
- Auth: HTTP bearer

Sends a test message from an existing Broadcast that has an email delivery connection. Provide a saved Subscriber ID for personalization; use subscribers_list to find one when needed. The recipient may be any test inbox and does not have to match the saved Subscriber.

## Path parameters

- `broadcast_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- BroadcastTestRequest
  - `recipient` string, email, required: The inbox that receives the test message. It may differ from the saved Subscriber used for personalization.
  - `subscriber_id` string, required: Required saved Subscriber ID whose profile supplies personalization. Use subscribers_list to find one before sending the test when needed.

## Response `200`

Test email sent

- object
  - `data` BroadcastTestResult, required
    - `provider_message_ids` string[]: Provider acceptance IDs in sent-message order; null when unavailable. These are not delivery or inbox receipts.
    - `status` 'completed', required
    - `subscriber_id` string, required

## Other responses

- `400`: Request is invalid
- `404`: Resource not found

---

[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)