ParagraphDocs
Open the app
GuidesDevelopers

Import subscribers from CSV

POST
/v1/subscribers/import

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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.

Request Body

Body

multipart/form-data
  1. body
file?unknown

CSV file containing subscriber data (max 10MB)

Response Body

Import started successfully

application/json
  1. response
success*true

Whether the import was started

Value intrue
curl -X POST "https://example.com/v1/subscribers/import"
{  "success": true}

Create a post's content group POST

Get the group a post belongs to, creating it if this is the first thing made from that post. This is the first call in a repurposing pipeline: seed the group from the post, then pass the id as `bucketId` on every `POST /v1/content` derived from it. The writer then sees the post and its versions as one row under Content instead of unrelated drafts. Safe to call repeatedly — a post that already has a group gets the same id back, and nothing is written.

List subscribers GET

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)