Authentication

API keys and authentication

Overview

The API uses Bearer token authentication. Include your API key in the Authorization header of each request.

Creating an API Key

  1. Navigate to your project settings
  2. Go to the "API Access" section
  3. Click "Create API Key"
  4. Select the required scopes for your use case
  5. Copy and securely store your API key (it starts with rsl_)

Example Request

curl https://app.resletter.com/api/v1/subscribers \
  -H "Authorization: Bearer rsl_your_api_key_here"

API Scopes

API keys can have different scopes to limit their permissions:

subscribers:read

List and view subscribers and groups

subscribers:write

Create and update subscribers (includes bulk operations)

subscribers:delete

Delete or unsubscribe subscribers

subscribers:*

Full subscriber permissions (read, write, delete)