Skip to content

API Reference

Welcome to the ProperSend API documentation. Our REST API allows you to programmatically manage your audiences, automate subscriber syncs, and trigger campaigns directly from your own applications.

Base URL

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Base URL:https://app.propersend.com

How to generate an API Token

To begin making requests to the API, you must first generate an API token. This token acts as your secret key and should be kept secure.

  1. Log in to your ProperSend Dashboard.
  2. Navigate to Settings and click on the Developer API tab.
  3. Click the Generate New Token button.
  4. Copy the token immediately. For security reasons, you will not be able to view it again.

Conventions

  • Content-Type: All POST and PATCH requests should be sent as application/x-www-form-urlencoded or application/json.
  • Accept Header: Always set the Accept: application/json header to ensure responses are correctly formatted.
  • Rate Limiting: Standard rate limits apply to prevent abuse. If you exceed the limit, you will receive a 429 Too Many Requests response.