Tool: email_addressbooks_variables_list
Input: {"id": "<addressbook-id>"}
Returns all custom variables defined for the list.
Find Subscribers by Variable
Tool: email_addressbooks_variables_emails_list
Input: {"id": "<addressbook-id>", "variable_name": "city", "variable_value": "Kyiv"}
Returns subscribers matching the variable filter — useful for segmentation.
Campaign History
List Campaigns for Addressbook
Tool: email_addressbooks_campaigns_list
Input: {"id": "<addressbook-id>"}
Returns campaigns that were sent to this list.
Common Workflows
Create List and Import Subscribers
1. email_addressbooks_create(name="Product Launch") -> Get list ID
2. email_addressbooks_emails_create(id, emails=[...]) -> Add subscribers
3. email_addressbooks_emails_total(id) -> Verify count
Segment by Variable
1. email_addressbooks_variables_list(id) -> See available variables
2. email_addressbooks_variables_emails_list(id, variable_name, variable_value) -> Get segment
Pre-Campaign Check
1. email_addressbooks_emails_total(id) -> Check audience size
2. email_addressbooks_cost(id) -> Verify cost within budget
3. email_campaigns_create(...) -> Proceed with campaign
Best Practices
Check cost before sending to avoid budget surprises
Use variables for personalization (name, city, plan, etc.)
Unsubscribe rather than delete to preserve records and comply with regulations
Segment by variables for targeted campaigns
Verify subscriber count after imports to confirm successful addition