API authentication

The Sidemail API uses API keys to authenticate requests. You can view and manage your API keys in the Sidemail Dashboard. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Your API keys give full access to your account, so keep them safe. Do not share your secret API keys in public places like GitHub or client-side code.

Using a library

If you use a library, configure it with your API key.

Making API requests manually

To authenticate, use the Authorization header in your HTTP request.

Include these HTTP headers when making an API request:

  • Content-Type: application/json to tell Sidemail you're sending JSON data
  • Authorization: Bearer replace-with-your-api-key to authenticate the API request with your API key