List subscribers
Retrieve a paginated list of subscribers for your publication. The publication is identified by the API key provided in the Authorization header.
Response:
- Returns subscriber email and/or wallet address
- Only active subscribers are returned
- Results are ordered by subscription date (newest first)
apiKeyAuthorizationBearer <token>API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.
cursor?stringCursor for pagination
limit?integerMaximum number of items to return (1-100, default: 10)
1 <= value <= 10010Subscribers retrieved successfully
application/json- response
items*array<>Array of items in this page
pagination*curl -X GET "https://example.com/v1/subscribers"{ "items": [ { "email": "user@example.com", "walletAddress": "string", "createdAt": 0 } ], "pagination": { "cursor": "string", "hasMore": true, "total": 0 }}Import subscribers from CSV POST
Import subscribers from a CSV file into your publication. The publication is identified by the API key provided in the Authorization header. **File Requirements:** - Maximum file size: 10MB - Content type: text/csv **Supported CSV Columns:** - Email: `email` or `subscriberEmail` (case-insensitive) - Wallet: `wallet_address` (case-insensitive) - Created date: `created_at`, `subscription date`, `created`, or `createdAt` (case-insensitive, optional) At least one of email or wallet_address must be present for each row. Rows with neither valid email nor valid wallet address will be skipped.
Add a new subscriber POST
Add a new subscriber to your publication. The publication is identified by the API key provided in the Authorization header. **Requirements:** - At least one of `email` or `wallet` must be provided - If both are provided, the subscriber will be associated with both credentials **Behavior:** - If the subscriber already exists (by email or wallet), they will not be duplicated