Questions? Feedback? powered by Olark live chat software

Email Marketing Software and Strategic Services | Email Marketing Canada

  604.357.7194



        Free Trial    Client Login

Learning Centre

Connect using our API

Use our open API to connect to your database…

Our API gives you the power to share data and information between bubblebox:mailer and third party systems, for example your CRM system, marketing database, website or Facebook page.

Whether you have a large IT team, or simply someone whom looks after your internal IT needs, using our API is a straightforward process.

The power to automate mundane processes not only allows your marketing team to be more creative and productive, it eliminates errors prone to occur with the human touch.

Get started with our open API

The API (Application Programming Interface) is a SOAP based web service built and maintained by bubblebox:mailer.

The API interface will allow your developers to interact with the bubblebox:mailer system programmatically, automating many everyday tasks you might otherwise have to carry out. This is useful if you wish to increase your productivity in the bubblebox:mailer system.

Why you might use the API

You can use the API to connect any system to bubblebox:mailer. Your CRM, website, or any back office system can be quickly connected allowing you to keep your data easily in sync. Data can be imported and exported on a schedule, and most common tasks available in bubblebox:mailercan be automated via the API.

You might find the API useful if you wish to integrate your CRM or database with bubblebox:mailer to ensure that the information shared between the two systems is kept effortlessly up to date and in sync.

Setting up your API key

To get started using our API you will need an API key. This API key is required to authenticate each method call you make and to make sure you are connected to the correct account. Setting one up is easy and can be done using the steps below:

  • Login to bubblebox:mailer

  • Click “My Account” in the top right corner

  • Click “Manage users” in the left hand menu

  • Click the “API” tab

  • Click “Add account”

  • The Username (email address) is automatically generated for you and must not be edited.

  • Enter a password

  • Check the enabled box is ticked

  • Click save

You will only be able to access the API using the API key although you can have more than one API key per bubblebox:mailer account.

If you cannot complete this process or some of the options don’t appear to you, please contact your main account holder who will be able to follow these steps to create your account for you. Please remember that not all bubblebox:mailer editions have the API available.

Setting up your API key

The bubblebox:mailer API uses “insert authentication here” to authenticate requests. We require that each method is authenticated with an API key consisting of a username formatted as an email address and a password set by yourself on creation of the API key. If you haven’t created your API key please follow the steps above to do so.

Call us on 604.357.7194 to turn on your API.

Authentication

The bubblebox:mailer API uses “insert authentication here” to authenticate requests. We require that each method is authenticated with an API key consisting of a username formatted as an email address and a password set by yourself on creation of the API key. If you haven’t created your API key please follow the steps above to do so.

Input and Output

SOAP is a standardised technology that takes in XML requests, and returns XML requests. When providing input you must ensure that the request is well-formed, paying attention to make sure that the xml request definition adheres to the required case sensitivity which can be different depending on the method you are calling. Please make sure to check the sample request and response for each method that you are going to call. When possible, we always recommend using an existing SOAP wrapper/library which can take care of any complications for you. The WSDL for the API can be found at http://apiconnector.com/API.asmx?WSDL.

When you are using dateTime values in your method calls please be aware that our API runs on UTC (Coordinated Universal Time) and will return all dateTimes in UTC. To make sure that you are using the correct time you can use GetServerTime to get the current time of the server our API runs on. This ensures that any time dependent routines will run at the expected time.

Restrictions

We set a limit of 15,000 API calls in a 24 hour period, when this limit is reached we will prevent further API calls to be made to that bubblebox:mailer account. Under normal usage conditions, you should not reach this limit. This limit is reset every 24 hours. We class each method call made with the exception of GetServerTime as one API call. We do reserve the right slow down the amount of calls made to the API if we detect unusual usage patterns and we do not store the actual API calls made to the account only the amount of calls made.


  • Login to bubblebox:mailer

  • Click “My Account” in the top right corner

  • Select “Current month activity”

  • At the bottom under API usage you should be able to see the total calls made for the month and the total calls in the last 24 hours.


Secure access

All your API requests can be made via http or https. We recommend that you use https for all requests. Our SSL uses an AES-128 bit certificate.

Testing

Whilst you are developing and testing your integration with our API we encourage you to signup and use a free trial account. This will ensure that all of your tests will not affect your live data. The trial account can then be extended by your account manager for any required additional time.

Not yet a bubblebox:mailer user? Try it now! free or contact us for a chat!

Try it now!   Get in touch

Client Testimonials

Through better email marketing practices, our customers will be more informed on products relevant to them."- Spa Boutique
We like to work with suppliers who are passionate about the clients they work with. It was clear throughout the sales process that the bubblebox:media team hold this quality."- Pacific National Exhibition
Now we have an established loyal customer base, with bubblebox:media’s help, it is the right time to deliver more targeted email dialogue."- Spa Boutique
Over the past couple of years bubblebox:media have taken us from basic level email blasting to now executing campaigns that are more personalized and informative."- Uniglobe Travel
It was crucial that we found a company such as bubblebox:media that could provide intelligent email delivery, a consultative approach and fast campaign turnaround times."- Pacific National Exhibition
We selected bubblebox:media based on their extensive experience and excellent track record in achieving great results for clients in the travel industry. Their proactive approach to consultancy via their Continuous Improvement Program was a key factor.”- WD World Travel
bubblebox:media are proactive in generating new ideas such as creative design improvements and tagging links to aid segmentation."- Uniglobe Travel
Working with bubblebox:media over the couple of years has been a delight. bubblebox:media bring to the table a high level of consultancy and superior technology knowledge.” - Travelzest plc
bubblebox:media’s process driven approach along with their innovative ideas and experience helped to make our decision easy."- Pacific National Exhibition
We chose bubblebox:media after being particularly impressed by the technology and their proven expertise."- itravel2000
Working with the bubblebox:media team, combined with access to the technology they deploy, we are now only limited by our own imagination and the creativity of our membership." - Uniglobe Travel
Delivering best practice email marketing programmes is an essential part of our business strategy. Appointing bubblebox:media makes perfect sense."- itravel2000