Send campaign test email

post

https://api.omnisend.com/api/campaigns/{id}/test-email

Render the campaign draft and email it to up to 5 recipients so the merchant (or their AI tool) can preview it without leaving the API. The test uses the campaign's saved subject, sender, and content; only email campaigns are supported.

Scopes:
campaigns.write

Rate Limiting:
This endpoint is rate limited to 400 requests per minute.

Headers

Omnisend-Version

string

required

Defaults to 2026-preview

API version that specifies the response format and behaviour

Responses

204

Test email queued for delivery

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

400Request contains invalid or missing fields

401Authentication is missing or invalid

402Payment is required to send this campaign

403Insufficient permissions for this operation

404Campaign not found

409Email sending is disabled, the sender domain is unverified, or every recipient is suppressed

410API version has been retired

422Campaign type is not supported (only email campaigns)

429Rate limit exceeded

500Unexpected error occurred