API Introduction

All the information about the API endpoints, authentication and response

The Mailazy API is built on HTTP:

  • Uses resource-oriented URLs
  • Uses built-in HTTP capabilities for passing parameters and authentication.
  • Responds with standard HTTP response codes to indicate errors.
  • Returns JSON.


Before you can start using the API, you need to do the following:

  1. Create a Mailazy account.
  2. Create an API Key and Secret.

Base URL



You authenticate to the Mailazy API by providing your API Key and Secret in the request. You can manage your access keys on the dashboard itself.

Authentication to the API can be done via HTTP Headers. Here is how you use basic HTTP auth with curl:

curl --header 'X-Api-Key: <Key>' \
     --header 'X-Api-Secret: <Secret>' \

Response Messages

All responses are returned in JSON format. We specify this by sending the Content-Type header.