Preview Emails API

Create a preview email

Send a campaign or autoresponder preview email.

Preview delivery settings in the System configuration must already be set.


Send a campaign preview email:

POST /ga/api/v2/campaigns/:campaign_id/send_preview

Send an autoresponder preview email:

POST /ga/api/v2/autoresponders/:autoresponder_id/send_preview

Request Payload

The payload for the request is a JSON document containing the email addresses
of the recipients.


array of strings
The email addresses to which to deliver the preview emails
Enable this to send the text and html portions of the content as separate emails.


The response will be an empty success response if the preview has been enqueued for delivery.

Failures can result from the following cases:

  • The campaign or autoresponder does not have any content configured.
  • The recipient list sent contains a string that is not a valid email address.
  • The system preview delivery settings have not yet been configured.

Example Request

Note that the JSON response will not be “pretty formatted” as it is below.

> POST /ga/api/campaigns/2/send_preview HTTP/1.1
> Authorization: Basic MTpmYzA2MzI4MjhjMThjMWIzMDgxYzAzNjI4ZTVlOTdmZjc4M2RiZjkx
> Accept: application/json
> Content-Type: application/json
  "preview": {
    "recipients": [
    "split_emails_by_format": true
< Content-Type: application/json; charset=utf-8
< X-UA-Compatible: IE=Edge
< ETag: "f744395dc73a323ce47b552d60a1c6cb"
< Cache-Control: max-age=0, private, must-revalidate
< Set-Cookie: _session_id=860cad951b67c6e411cb633efa437e76; path=/; HttpOnly
< X-Request-Id: b8247a3feecddf8397380ecd99f1f2ef
< X-Runtime: 0.085857
< Connection: close
< Server: thin 1.5.0 codename Knife
  "success": true,
  "data": null,
  "error_code": null,
  "error_message": null