Mailercloud API Documentation

The Mailercloud API provides access to Mailercloud data and functionality, allowing developers to sync data, manage contacts, lists, campaigns etc.

To use the Mailercloud API, you need a Mailercloud account. What you can do with the API depends on what level of Mailercloud plan you have. In your Mailercloud account you get the API creation option in settings. You can create up to 10 different API keys and you can delete an API key whenever you want . You can use this API key for accessing the Mailercloud API.

How to use the Mailercloud API

To authenticate, add an authorization header to your API request that contains an API key.

API Keys allow you to use another method of authentication separate from your account username and password. API Keys add an additional layer of security for your account. To use keys, you must set a plain text header named “authorization” with the contents of the header is your API Secret Key.

💡 Note: You are responsible for the security of your API key; we recommend that you store it in a secure location on your server. Because of the potential security risks associated with exposing your API key, Mailercloud does not support client-side implementation of our API using CORS requests.

API Limits

To secure from malicious usage we put some limits on API requests. These limits prevent a single user from making too many calls at once. Exceeding the limits can block your API.

API Request

The host for Web API v1 requests is always https://cloudapi.mailercloud.com/v1

You must provide an authorization header. At present we are supporting the following request headers

GET

POST

PUT

PATCH

DELETE

The API request currently supports only application/json data and the API provides JSON responses.

Sample

We're Here to Help

We look forward to hearing from you. Drop-in your queries here https://www.mailercloud.com/contact-us and we will be happy to answer.