Add audience members

POST

https://api.smallest.ai/atoms/v1/audience/:id/members

Add new members to an existing audience.

Each member object must include a key matching the audience’s phoneNumberColumnName. If it’s missing, the API returns 400: "Each member must have a <phoneNumberColumnName> field". Adding members that would exceed the audience limit also returns 400.

Note: if the audience belongs to a different organization, the API returns 404 (not 403).

Add new members to an existing audience. Each member object must include a key matching the audience's `phoneNumberColumnName`. If it's missing, the API returns 400: `"Each member must have a <phoneNumberColumnName> field"`. Adding members that would exceed the audience limit also returns 400. Note: if the audience belongs to a different organization, the API returns 404 (not 403).

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The unique identifier of the audience

Request

This endpoint expects an object.

memberslist of objectsRequired

Array of member objects with dynamic structure based on audience configuration

Response

Members added successfully

statusboolean

datalist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

1	from smallestai import SmallestAI
2
3	client = SmallestAI(
4	token="YOUR_TOKEN_HERE",
5	)
6
7	client.atoms.audience.add_audience_members(
8	id="60d0fe4f5311236168a109ca",
9	members=[
10	{}
11	],
12	)

1	{
2	"status": true,
3	"data": [
4	{
5	"message": "5 members added successfully",
6	"data": {
7	"added": 5,
8	"skipped": 2
9	}
10	}
11	]
12	}