create_interest_category
Create an interest category in a Mailchimp audience to organize subscriber preferences into groups like checkboxes or dropdowns.
Instructions
Create a new interest category (group container) in an audience for organizing subscriber preferences.
Use to create a container for interest options. Typical workflow: create_interest_category -> create_interest (add options within the category). The type controls how subscribers interact with it on signup forms. Use list_interest_categories to check existing categories first.
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. title: Display title for the category (e.g. 'Preferred Topics'). Must be unique within the audience. type: How the category appears on signup forms. Valid values: 'checkboxes' (subscribers can select multiple), 'dropdown' (single select), 'radio' (single select), 'hidden' (not shown on forms, managed via API only).
Returns: JSON with fields: id (string, use with create_interest, list_interests, delete_interest_category), title, type, list_id.
Example: create_interest_category(list_id="abc123", title="Newsletter Preferences", type="checkboxes") -> {"id": "cat456", "title": "Newsletter Preferences", "type": "checkboxes", ...}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| title | Yes | ||
| type | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |