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

Email Subscriber Management

Topics covered:

introduction

Subscriber management is the most commonly used area of the email blaster API. This allows your CRM or website to sync records with your email blaster. In this guide you will learn the basics of how to interact with your subscriber records, from: adding a subscriber, making amends to a record, removing a record and searching for a specific subscriber.

add a subscriber

This request will allow you to add a subscriber to an already existing mailing list inside your email blaster.

Note: Check out the mailing lists section to learn how to create a new mailing list, or fetch the ID number of an existing mailing list to make a subscribe request against.

To make a subscribe request, please make a POST request to the following address:

https://api.emailblaster.cloud/2.0/subscriber/subscribe

The request should be a JSON object containing your subscriber information:

{
       "salutation":"Mr",
       "first_name":"Chris",
       "surname":"Bob",
       "company":"bobs cakes ltd",
       "ref":"123456",
       "email":"chrisbob@example.com",
       "list":"257"
    }
  
Mandatory fields: email, list

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

{
   "status":"ok",
   "subscriber_id":92028
  }

update a subscriber

This call is made in order to make an update/amend to a subscriber record. For example, your subscriber may have a new preferred email address and you need to update your records accordingly.

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

https://api.emailblaster.cloud/2.0/subscriber/update/{id}
{id} should contain the subscriber_id which you wish to amend.

The request should be a JSON object containing your amended information. You only need to provide the data which you wish to update:

{
   "email":"jess@example.com",
   "salutation":"Dr",
   "name":"Jess",
   "surname":"Glover",
   "company":"my company ltd",
   "ref":"abc123",
   "list":"405"
}
Note: You can swap a subscriber to a new list by providing the new destination list id in the 'list' field.

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

{"status":"ok"}

remove a subscriber

This request to the API can be used to remove / delete a subscriber from your email blaster. The update takes affect instantly, the subscriber will be removed from any existing or planned future sends.

This is a one way process, a deleted subscriber cannot be recovered. If you remove a subscriber by mistake, they can be re-added using a new subscribe request.

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

https://api.emailblaster.cloud/2.0/subscriber/delete/{id}
{id} should contain the subscriber_id which you wish to remove.

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

{"status":"ok"}

subscriber search

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

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

You can also search by subscriber name, company name, email address or any item of data which will easily distinguish your subscriber from your database.

In each case the subscribers full contact card 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/subscriber/search

Your search request should contain the following JSON data:

{"search_string":"bob@example.com"}
A maxium of 50 records will be returned.

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

{
   "status":"ok",
   "matches":[
      {
         "id":67140,
         "salutation":"Mr",
         "first_name":"Paul",
         "surname":"Smith",
         "company":"Bob Cakes Ltd",
         "ref":"abc/123",
         "email":"paul.smith@example.com",
         "list":"265",
         "list_name":"Weekly List"
      },
      {
         "id":133,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Park",
         "company":"Bob Cakes Ltd",
         "ref":"dfg/456",
         "email":"bob.p@example.com",
         "list":"174",
         "list_name":"Latest Customers"
      },
      {
         "id":739,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Keller",
         "company":"Keeper Ltd",
         "ref":"dfg/124",
         "email":"bob@example.com",
         "list":"174",
         "list_name":"Latest Customers"
      },
      {
         "id":1345,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Shaker",
         "company":"Shaker Ltd",
         "ref":"165/fgt",
         "email":"bob.s@example.com",
         "list":"175",
         "list_name":"New Final Ai test B4"
      },
      {
         "id":22588,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Lark",
         "company":" Lark Pies Ltd",
         "ref":"",
         "email":"bob.lark@example.com",
         "list":"181",
         "list_name":"Group One"
      },
      {
         "id":22006,
         "salutation":"Dr",
         "first_name":"Bob",
         "surname":"Keeper",
         "company":"Bob The Dr",
         "ref":"452/56f",
         "email":"bob.keeper@example.com",
         "list":"181",
         "list_name":"Group One"
      },
      {
         "id":5204,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Bird",
         "company":" Bird Ltd",
         "ref":"45f/fhj",
         "email":"boberster@example.com",
         "list":"174",
         "list_name":"Latest Customers"
      },
      {
         "id":7898,
         "salutation":"Mr",
         "first_name":"Bob",
         "surname":"Smiths",
         "company":"JPop Ltd",
         "ref":"4345/ffd",
         "email":"bob@example.com",
         "list":"237",
         "list_name":"June Subscribes"
      }
   ]
}

fetch subscriber

The subscriber fetch function can be used to return the details of a specific subscriber. This request is used when you already know the subscriber's ID and wish to pull the full contact card for this user.

To perform a fetch request, you will need to make a GET lookup to the following URL:

https://api.emailblaster.cloud/2.0/subscriber/fetch/{id}

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


  {
   "status":"ok",
   "subscriber":{
      "id":186099,
      "salutation":"Dr",
      "first_name":"Jess",
      "surname":"Glover",
      "company":"my company ltd",
      "ref":"abc123",
      "email":"jess@example.co.uk",
      "list":"118",
      "list_name":"June list"
   }
}
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