Preview Emails API

• Table of Contents
• Create a preview email
  • URL
  • Request Payload
  • Response
  • Example Request

Create a preview email

Send a campaign or autoresponder preview email.

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

URL

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.

Response

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": [
      "user-1@example.com",
      "user-2@example.com"
    ],
    "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
}