create_audience
Create a new audience list with contact info, campaign defaults, and permission reminder for CAN-SPAM compliance.
Instructions
Create a new audience (list) with required contact info, campaign defaults, and permission reminder.
Side effect: creates a billable audience under the Mailchimp plan. Mailchimp requires all contact fields (company, address, city, state, zip, country) and CAN-SPAM-compliant permission reminder text. Use update_audience to modify later, delete_audience for cleanup, or list_audiences to verify creation.
Authenticated via API key. Max 10 concurrent requests. Respects read-only and dry-run modes. Returns 400 error if any required field is missing or the plan audience limit is reached.
Args: name: Audience display name shown in dashboard and audience picker (max 100 chars). from_name: Default sender name on campaigns (e.g. 'Marketing Team'). Max 100 chars. from_email: Default sender email. Must be on a verified sending domain. subject: Default subject line for new campaigns. Max 150 chars. language: Default language code (e.g. 'en', 'fr', 'es'). ISO 639-1 two-letter code. company: Legal company name displayed in email footer (required by CAN-SPAM). address1: Primary postal address line shown in email footer. city: City of the postal address. state: State or region of the postal address. zip: Postal/ZIP code. country: Two-letter ISO country code (e.g. 'US', 'FR', 'GB'). permission_reminder: Sentence shown at the bottom of every email explaining why subscribers receive it (required by CAN-SPAM). email_type_option: If true, lets subscribers choose plaintext vs. HTML emails. Default false. address2: Optional secondary postal address line. phone: Optional contact phone number shown in the footer.
Returns: JSON with id (new list_id, save for subsequent calls), name, member_count (0 at creation), date_created, subscribe_url_short.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| from_name | Yes | ||
| from_email | Yes | ||
| subject | Yes | ||
| language | Yes | ||
| company | Yes | ||
| address1 | Yes | ||
| city | Yes | ||
| state | Yes | ||
| zip | Yes | ||
| country | Yes | ||
| permission_reminder | Yes | ||
| email_type_option | No | ||
| address2 | No | ||
| phone | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |