REST API v2: GET scheduledemailing (Marketing Suite)
A scheduled mailing is a mailing that was scheduled. It can be send immediately or in the future, one or multiple times. You can use the REST API to retrieve a summary of a scheduled mailing with an HTTP GET call to the following URL:
https://api.copernica.com/v2/ms/scheduledemailing/$id?access_token=xxxx
Where $id
should be replaced with the ID of the mailing you want summarized.
Returned fields
The method returns a JSON object containing the following information:
- id : The ID of the mailing.
- start : The start date of the mailing (YYYY-MM-DD HH:MM:SS format).
- rrule : The RRule for the mailing (more information below)
- template : The ID of the template that was used to send the mailing.
- next : The timestamp of the next occurrence of this mailing
- previous : The timestamp of the previous occurrence of this mailing.
- subject : The subject of the mailing.
- from_address : An array containing the 'name' and 'email' address of the sender.
- type : Type of mailing (individual or mass).
- target : Contains the target type and the ID and type of other entities above it (for example the database a collection belongs to).
- tags : An array with tags used in the mailing.
RRules
An RRule is a rule that specifies recurrence, for example for an emailing that should be sent monthly. The RRules used within Copernica follow the iCalendar format (RFC 5545). There are several tools on the internet that will help you create and understand RRules, such as the tool on the iCalendar website.
JSON example
The JSON for the emailing looks something like this and can be found in the 'data' property of the output:
{
"id":"1742",
"start":"2019-06-27 17:30:00",
"rrule":"FREQ=DAILY;COUNT=2",
"template":"2112",
"next":"2019-06-28 17:30:00",
"previous":"2019-06-27 17:30:00",
"subject":"Test emailing",
"from_address":{
"name":"Test",
"email":"test@copernica.com"
},
"type":"mass",
"target":{
"type":"database",
"sources":[
{
"id":"7141",
"type":"database"
}
]
},
"tags":[
"test1",
"Test2"
]
}
PHP example
The script below demonstrates how to use this API method. Don't forget to replace the ID in the URL before executing the call.
// dependencies
require_once('copernica_rest_api.php');
// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 2);
// execute the call
print_r($api->get("ms/scheduledemailing/{$scheduledemailingID}", $parameters));
This example requires the REST API class
More information
- Overview of all REST API calls
- GET Marketing Suite mailings
- GET Marketing Suite scheduled mailings
- POST Marketing Suite scheduled emailing
The following tools will help you get acquainted with RRules: