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

List & Folder Management

Topics covered:

introduction

This section of the email blaster API focuses around the management and organisation of your subscribers. The tools available inside this area of the API allow you to effectively manage and organise large volumes of subscribers.

Subscribers are organised using the following structure tree: Folders > Mailing Lists > Subscribers.

Folders can be created to store groups of mailing lists. Each mailing list can contain up to 25,000 subscribers.

create a folder

A folder can contain a group of mailing lists. This request will create a new folder ready to store a set of mailing lists. A new folder can be created with a POST request to the following address:

https://api.emailblaster.cloud/2.0/lists/foldercreate

The request should be a JSON object containing your desired folder name:

{"name":"bob's account"}

After a successful request, the following data will be returned. The value named ‘folder_id' will contain the unique ID number of your newly added folder. You may wish to store this inside your CRM or database for making additional future calls against this folder.

{
   "status":"ok",
   "folder_id":43
  }

list folders

This API call will output a list of all existing folders and their associated {id}. You may wish to store the {id} for use with future calls against a specific folder.

This request can be made with a GET call against the following URL:

https://api.emailblaster.cloud/2.0/lists/folderview
After a successful request, the following data will be returned. The value named 'folders' will contain the {id} and {name} of each folder.
{
   "status":"ok",
   "folders":[
      {
         "id":12,
         "name":"bob folder"
      },
      {
         "id":13,
         "name":"weekly newsletter lists"
      },
      {
         "id":18,
         "name":"CRM users"
      }
   ]
}

update a folder

This request to the API can be used to change the name of a mailing list folder contained within your email blaster. This request should be made with a PATCH call to the following URL:

https://api.emailblaster.cloud/2.0/lists/folderupdate/{id}
{id} should contain the folder_id which you wish to patch.
Your request should also contain the following JSON data:
{
     "name":"New Folder Name"
}

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

{"status":"ok"}

delete a folder

This request to the API can be used to remove / delete a folder from your email blaster. Any mailing lists and associated subscribers contained within this folder will also be removed. This is a one way process which takes place instantly after the call is made.

To remove a folder, you will need to make a DELETE request. This request should be made against the following URL:

https://api.emailblaster.cloud/2.0/lists/folderdelete/{id}
{id} should contain the folder_id which you wish to delete.

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

{"status":"ok"}

create a mailing list

This API request will create a new mailing list inside your email blaster. Once created, the mailing list {id} will be returned. You can store the returned {id}, using it in future subscribe calls.

You can create a new mailing list by making a POST request to the following URL:

https://api.emailblaster.cloud/2.0/lists/create
Your request should contain the following JSON data:
{
     "name":"New Mailing List",
     "folder_id":"28",
     "type":"B2B",
     "third_party":"N"
  }
folder_id => mailing list parent folder {id} [Required Field]
type => B2B or B2C [Required Field]
third_party => Y/N [Specify if list has been generate by a 3rd party] [Required Field]

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

{
  "status":"ok",
  "list_id": "43"
}

delete a mailing list

This request to the email blaster API will allows you to delete a mailing list. This is a one way process, any subscribers assigned to this mailing list will also be deleted.

The action can achieved by making a DELETE request to the following URL:

https://api.emailblaster.cloud/2.0/lists/delete/{id}
{id} should contain the list_id which you wish to delete.

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

{"status":"ok"}

update a mailing list

This call will make an update/amend to a mailing list. For example, you may wish to give your mailing list a new name.

To update a mailing list, you will need to make a PATCH request. Your request should be made to the following URL:

https://api.emailblaster.cloud/2.0/lists/update/{id}
{id} should contain the list_id which you wish to update.

Your request should also contain the following JSON data (you only need to define the values which you need to update):

{
  "name":"bob mailing list",
  "folder": "43"
}
name => new mailing list name. (optional)
folder => Assign mailing list to a new parent folder by providing new parent folder id. (optional)

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

{"status":"ok"}

view mailing lists

This request to the email blaster API can be made to return the mailing lists which you have stored in a specific folder. The {folder_id} should be provided in the query URL:

Construct a GET request to the following URL:

https://api.emailblaster.cloud/2.0/lists/index/{folder_id}

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

{
   "status":"ok",
   "lists":[
      {
         "id":214,
         "name":"New Customers",
         "contacts":"309",
         "folder":24,
         "lqf":"95"
      },
      {
         "id":260,
         "name":"List One",
         "contacts":"1023",
         "folder":24,
         "lqf":"98"
      },
      {
         "id":259,
         "name":"Latest Signups",
         "contacts":"4054",
         "folder":24,
         "lqf":"91"
      },
      {
         "id":262,
         "name":"new list",
         "contacts":"15",
         "folder":24,
         "lqf":"93"
      }
   ]
}

view mailing list subscribers

Use this call to return all subscribers assigned to a specific mailing list. Ideally suited if you need to update your CRM system or sync with your own internal database.

To perform this call, you will need to build a GET request. Your request should be made to the following URL:

https://api.emailblaster.cloud/2.0/lists/view/{id}
{id} should contain the list_id which you wish to view.

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

{
   "status":"ok",
   "subscribers":[
      {
         "id":67143,
         "salutation":"Dr",
         "first_name":"Chris",
         "surname":"Smith",
         "company":"Smiths Ltd",
         "ref":"",
         "email":"chrisbob@example.com"
      },
      {
         "id":67144,
         "salutation":"Mr",
         "first_name":"James",
         "surname":"Bob",
         "company":"",
         "ref":"123456",
         "email":"james@example.com"
      },
      {
         "id":67145,
         "salutation":"Ms",
         "first_name":"Sarah",
         "surname":"Bob",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"sarah@example.com"
      },
      {
         "id":67146,
         "salutation":"Mrs",
         "first_name":"Sophie",
         "surname":"Sams",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"sophie@example.com"
      },
      {
         "id":67147,
         "salutation":"Miss",
         "first_name":"Laura",
         "surname":"Clark",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"laura@example.com"
      },
      {
         "id":67148,
         "salutation":"Mr",
         "first_name":"Chris",
         "surname":"Lark",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"chris.l@example.com"
      },
      {
         "id":67149,
         "salutation":"Mr",
         "first_name":"Barry",
         "surname":"Scott",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"barry@example.com"
      },
      {
         "id":67150,
         "salutation":"Ms",
         "first_name":"Sam",
         "surname":"Snape",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"sam@example.com"
      },
      {
         "id":67151,
         "salutation":"Mrs",
         "first_name":"Betty",
         "surname":"Marks",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"betty@example.com"
      },
      {
         "id":67152,
         "salutation":"Mr",
         "first_name":"Martin",
         "surname":"Parks",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"martin@example.com"
      },
      {
         "id":67153,
         "salutation":"Miss",
         "first_name":"Poppy",
         "surname":"Price",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"poppy@example.com"
      },
      {
         "id":92028,
         "salutation":"Mr",
         "first_name":"Chris",
         "surname":"Pams",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"chris.p@example.com"
      },
      {
         "id":92027,
         "salutation":"Mr",
         "first_name":"Marc",
         "surname":"Call",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"marc@example.com"
      },
      {
         "id":92026,
         "salutation":"Mr",
         "first_name":"Nick",
         "surname":"Pick",
         "company":"bobs cakes ltd",
         "ref":"123456",
         "email":"nica@example.com"
      }
   ]
}
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