audiences
Create and manage reusable contact lists, add contacts with custom variables, and target them in WhatsApp messages or campaigns.
Instructions
Reusable contact lists used as targets for messages and campaigns. Available actions:
list: list audiences
create: create a new audience by name
get / update / delete: standard CRUD on an audience
append_contacts: add contacts (to + optional variables) to an audience
update_contact / remove_contact: edit or remove a single contact within an audience
Phone format: to must be in international format (e.g. +14155551234). JID form (12345@c.us) is rejected here.
Variables: each key on variables becomes a {key} token usable in campaign templates (case-insensitive).
Custom tokens override built-ins: setting variables.firstName='Doug' makes {firstName} resolve to Doug instead of the WA profile name.
Built-ins always available even without variables: whatsappname, displayname, phone, mobile.
Examples:
create: 'create an audience called Leads'
append_contacts: 'add +972544325389 to the Leads audience with firstName=Doug, product=Premium'
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| name | No | ||
| skip | No | ||
| limit | No | ||
| action | Yes | ||
| contacts | No | ||
| variables | No | ||
| contact_id | No | ||
| audience_id | No |