---
title: "Send automation test messages"
method: POST
path: "/v1/automations/{automation_id}/test"
tags: ["Automations"]
---

# Send automation test messages

`POST /v1/automations/{automation_id}/test`

## Request

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

Sends up to five selected saved Automation email steps to one explicit test address. This does not start the Automation or run other actions.

## Path parameters

- `automation_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- WorkflowTestRequest
  - `recipient` string, email, required
  - `subscriber_id` string, required: The saved Subscriber whose personalization should be rendered in every test message.
  - `message_ids` string[]: Optional Sequence email IDs or Automation step IDs. Omit to test the first five available messages.

## Response `200`

Automation test messages sent

- object
  - `data` WorkflowTestResult, 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
    - `sent_count` integer, required
    - `message_ids` string[], required

## Other responses

- `400`: Request is invalid
- `404`: Automation not found
- `429`: Too many test messages 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)