Send Email Preview

Use this method to send a preview email to a specific email address. You must specify the ID of the email you want to preview, and the email address of the recipient you want the system to send the preview to.

The Method

API Method
RESTPOSThttp://[Your URL]/api/2.0/email_preview/:id/:recipient
Your URL is the address of your Everlytic install.

Your method must be structured as follows:

PreviewEmail(integer $id, string $recipient) : boolean


Required Parameters

The following parameters are required for this method to work:

$idintegerThe ID of the email to create a preview of.yes
$recipientstringThe email address of the person to which the preview must be sent.yes


booleanIf the preview was successful or not.

Code Samples

PHP (using REST API)


The rest of this document describes the example above, step-by-step.

In our Getting Started section we covered the four important components of an API request; URL, method, headers, and body.


Let's analyse the code sample above to determine where each line fits into this outline.

1. Set recipient email

The following line of code sets the email of the recipient of the preview email in a parameter.

$recipient = '';

2. Load the Everlytic API

The following line of code tells the server which API URL to access for the request, as well as the email of the recipient defined in the $recipient parameter:

$url = '(Your URL)/api/2.0/email_actions/email_preview/:email_id/' . $recipient;

3. Method

In this line of code, you tell the API which REST function to use:

$method = ‘POST’;

4. cURL

cURL is a tool for sending and receiving files from a web server. This line of code initialises the cURL session.

$cSession = curl_init();

5. Initiate the headers

This section of the code opens the headers section and passes the authentication (including your API key).

$headers = array();

$auth = base64_encode($username . ':' . $apikey);

$headers[] = 'Authorization: Basic ' . $auth;

6. Set various cURL options for the session

The first line uses the $url to get your specified url
The second line returns the string (text) of the return value.
The third line tells the server not to include the header in the ouput.
The fourth line calls the $method specified above.

curl_setopt($cSession, CURLOPT_URL, $url);

curl_setopt($cSession, CURLOPT_RETURNTRANSFER, true);

curl_setopt($cSession, CURLOPT_HEADER, false);

curl_setopt($cSession, CURLOPT_CUSTOMREQUEST, strtoupper($method));

7. Headers

Call the headers using the $headers method.

curl_setopt($cSession, CURLOPT_HTTPHEADER, $headers);

8. Output the API response to test authentication

$result = curl_exec($cSession);

9. Close the cURL session

Translate »