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 APIThe 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 APIYou 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.
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 keyThe 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.
AuthenticationThe 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 OutputSOAP 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.
Secure accessAll 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.
TestingWhilst 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