An Audience is a curated list of phone numbers your campaigns will dial. Think of it as a segment—leads to call, customers to survey, appointments to confirm.
Use create_audience with a list of phone numbers and optional contact names:
The response confirms creation with the audience ID:
Phone numbers must use E.164 format: + followed by country code and number. Example: +916366821717
list() returns all audiences with their campaign associations:
Each audience includes campaign associations and member counts:
get_members() returns a paginated list of contacts in the audience:
Each member stores their contact data:
add_contacts() appends new contacts to an existing audience:
The response reports how many were added:
delete() removes the audience and all its members:
Audiences with active campaigns cannot be deleted. Complete or delete the campaigns first.
E.164 format is required: + followed by country code and number with no spaces or dashes. Example: +14155551234 for US, +916366821717 for India.
Currently, you can add new members but not update existing ones. To change a contact’s info, delete and recreate the audience or add the corrected record (duplicates are skipped).
Audiences can scale to thousands of contacts. For very large lists, consider splitting into segments for easier management.
Members with duplicate phone numbers within the same audience are skipped. Check that each phone number is unique.