create_interest
Add a new selectable interest option to an existing interest category, making it available on signup forms.
Instructions
Create a new interest option within an interest category (e.g. add "Tech" to a "Topics" category).
Use after create_interest_category to add selectable options. Each option becomes available on signup forms (unless category type is 'hidden'). Use list_interests to check existing options. Use delete_interest to remove an option.
Authenticated via API key. Subject to Mailchimp API rate limits (max 10 concurrent requests). Respects read-only and dry-run modes.
Args: list_id: The Mailchimp audience/list ID (e.g. 'abc123def4'). Obtain from list_audiences. category_id: The interest category ID. Obtain from list_interest_categories or create_interest_category. name: Display name for the interest option (e.g. 'Tech', 'Sports'). Must be unique within the category.
Returns: JSON with fields: id (string, use with delete_interest), name, subscriber_count (int, starts at 0).
Example: create_interest(list_id="abc123", category_id="cat456", name="Technology") -> {"id": "int789", "name": "Technology", "subscriber_count": 0}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| category_id | Yes | ||
| name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |