Get all audiences

Get all audiences

curl --request GET \
  --url https://atoms-api.smallest.ai/api/v1/audience \
  --header 'Authorization: Bearer <token>'

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

GET

audience

Get all audiences

curl --request GET \
  --url https://atoms-api.smallest.ai/api/v1/audience \
  --header 'Authorization: Bearer <token>'

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successfully retrieved audiences

status

boolean

Example:

true

data

object[]

Show child attributes

data._id

string

The unique identifier for the audience

Example:

"60d0fe4f5311236168a109ca"

data.name

string

The name of the audience

Example:

"My Customer List"

data.description

string

The description of the audience

Example:

"List of customers for marketing campaign"

data.phoneNumberColumnName

string

The name of the column in the CSV that contains phone numbers

Example:

"phoneNumber"

data.organization

string

The organization ID

Example:

"60d0fe4f5311236168a109cb"

data.createdBy

string

The user ID who created the audience

Example:

"60d0fe4f5311236168a109cc"

data.createdAt

string<date-time>

The date and time when the audience was created

Example:

"2025-01-15T10:30:00.000Z"

data.updatedAt

string<date-time>

The date and time when the audience was last updated

Example:

"2025-01-15T10:30:00.000Z"

Delete a webhook Create audience with CSV upload

⌘I

User

Organization

Agent Templates

Agents

Workflows

Logs

Calls

Campaigns

Knowledge Base

Phone Numbers

Webhooks

Audience

Authorizations

Response