v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0114775543.6 KB
Audience

Create audience with CSV upload

Create a new audience by uploading a CSV file containing phone numbers. Only CSV text files are accepted — binary files will produce malformed data.

Additional 400 cases:

  • Duplicate phone numbers in the CSV: "Some phone numbers in your CSV already exist in this audience. Please remove duplicate entries and try again."
  • Member limit exceeded: "Audience cannot exceed X members"
post/audience

Response

Audience created successfully

statusboolean

Example response

{
  "status": true,
  "data": {
    "_id": "60d0fe4f5311236168a109ca",
    "name": "My Customer List",
    "description": "List of customers for marketing campaign",
    "phoneNumberColumnName": "phoneNumber",
    "identifierColumnName": "Name",
    "organization": "60d0fe4f5311236168a109cb",
    "createdBy": "60d0fe4f5311236168a109cc",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  }
}