overview your first call subscribers mailing lists list ai campaigns sender profiles send campaign analytics

Campaign Management

Topics covered:

introduction

The campaign area of the email blaster API allows you to effectively view and manage your sent / unsent campaigns. Find out how to quickly preview, clone and manage your setup campaigns.

view sent / unsent campaigns

Campaigns are split into two categories: sent and unsent. A sent campaign is a campaign that has been delivered or scheduled to be delivered to one of your mailing lists. An unsent campaign is a campaign that has been previously created, but has not yet been sent.

Using this API call, you can either return a full listing of your sent or unsent campaigns. To return a listing of your unsent campaigns, construct a GET to the following URL:

https://api.emailblaster.cloud/2.0/campaign/view/unsent

Alternatively, to return a listing of your sent / scheduled to be sent campaigns, construct a GET to the following URL:

https://api.emailblaster.cloud/2.0/campaign/view/sent
{
   "status":"ok",
   "campaigns":[
      {
         "id":798,
         "name":"Bob July Campaign",
         "subject":"Our summer newsletter",
         "date":"03\/08\/2017",
         "send_volume":"309",
         "sent_to":"Customers",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc5OA"
      },
      {
         "id":796,
         "name":"Bob August Campaign",
         "subject":"August is here!",
         "date":"12\/08\/2017",
         "send_volume":"4268",
         "sent_to":"241",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc5Ng"
      },
      {
         "id":800,
         "name":"Bob September Campaign",
         "subject":"September Newsletter",
         "date":"03\/09\/2017",
         "send_volume":"309",
         "sent_to":"n\/a",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTgwMA"
      },
      {
         "id":779,
         "name":"Bob October Campaign",
         "subject":"A spooky newsletter",
         "date":"12\/10\/2017",
         "send_volume":"3045",
         "sent_to":"n\/a",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc3OQ"
      },
      {
         "id":224,
         "name":"Bob November Campaign",
         "subject":"It is cold, it is dark!",
         "date":"12\/12\/2016",
         "send_volume":"456",
         "sent_to":"n\/a",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTIyNA"
      },
      {
         "id":785,
         "name":"Bob December Campaign",
         "subject":"It is still cold, it is still dark!",
         "date":"20\/12\/2017",
         "send_volume":"0",
         "sent_to":"264",
         "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc4NQ"
      }
   ]
}

In both a sent / unsent call, the same field names are returned. The {preview} value contains a unique web link to preview the design / content of your newsletter.

clone campaign

The clone facility is perfect to re-use a previously sent campaign without changing the content. This API section can also be used if you have a set of templates which you wish to use on a regular basis. For each send, a clone API call can be made to create a copy of the desired template.

To perform a clone action, you will need to make a GET request. Your request should be made to the following URL:

https://api.emailblaster.cloud/2.0/campaign/clone/{id}
{id} should contain the campaign_id to clone.

After a successful clone request, the following JSON response will be returned:

{
   "status":"ok",
   "id":"145"
}
{id} contains the id of your newly created clone.

campaign search

The campaign search function can be used to return the details of a specific campaign, or set of campaigns against your own search criteria.

In the most basic form, if you know your campaign_id, you can simply submit the campaign_id.

You can also search by campaign name, subject line, date, linked mailing list name or any item of data which will easily distinguish your campaign from your database.

In each case the full campaign details and status will be returned.

To perform a search, you will need to make a POST request. Your request should be made to the following URL:

https://api.emailblaster.cloud/2.0/campaign/search

The request should be a JSON object containing the following information:

{"search_string":"June newsletter"}
A maximum of 50 records will be returned.

After a successful request, the following JSON response will be returned:

{
     "status":"ok",
     "campaigns":[
        {
           "id":798,
           "name":"June newsletter",
           "subject":"Our June Newsletter",
           "date":"03\/06\/2017",
           "send_volume":"309",
           "sent_to":"n\/a",
           "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc5OA"
        },
        {
           "id":449,
           "name":"June newsletter 2",
           "subject":"Hot June Deals",
           "date":"27\/06\/2016",
           "send_volume":"10345",
           "sent_to":"n\/a",
           "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTQ0OQ"
        },
        {
           "id":779,
           "name":"June Newsletter 3",
           "subject":"June summer deals",
           "date":"12\/06\/2017",
           "send_volume":"3045",
           "sent_to":"n\/a",
           "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTc3OQ"
        },
        {
           "id":224,
           "name":"June Newsletter 4",
           "subject":"Welcome to summer",
           "date":"12\/06\/2016",
           "send_volume":"1",
           "sent_to":"n\/a",
           "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTIyNA"
        },
        {
           "id":444,
           "name":"June Newsletter 5",
           "subject":"Summer promo",
           "date":"22\/06\/2016",
           "send_volume":"",
           "sent_to":"n\/a",
           "preview":"http:\/\/ebtk.co.uk\/tools\/webversion?quickcode=NDY2LTQ0NA"
        }
     ]
  }

delete campaign

If a campaign is no longer required, you can use the email blaster API to permanently delete this campaign. Deleting a campaign is a one way process and cannot be undone. If you choose to delete a sent campaign, associated analytics data will also be removed.

This call is not suited to cancel a scheduled send. A delete campaign call will simply attempt delete the campaign, not a send. If a future send is setup on the target campaign, the delete request will fail, you will first need to cancel off any attached sends (see send campaign section of API docs).

To run a campaign delete request, this can be done using a DELETE call to the following API URL:

https://api.emailblaster.cloud/2.0/campaign/delete/{id}
{id} should contain the campaign_id which you wish to delete.
{"status":"ok"}
Give us a call
01327
438077
Connect
Let's go
Where? Unit 10A
Burcote Wood Business Park
Towcester
Northants
NN12 8TA
Email Blaster is a trading name of JC Peters Ltd registered in England & Wales no. 07168254