Skip to navigation
API ReferenceLists

Add interest in category

Create a new interest or ‘group name’ for a specific category.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

OR
AuthorizationBearer
Authorization using OAuth

Path parameters

list_idstringRequired
The unique ID for the list.
interest_category_idstringRequired
The unique ID for the interest category.

Request

Assign subscribers to interests to group them together. Interests are referred to as 'group names' in the Mailchimp application.
namestringRequired
The name of the interest. This can be shown publicly on a subscription form.
display_orderintegerOptional
The display order for interests.

Response

This endpoint returns an object.
category_idstringOptionalRead-only
The id for the interest category.
display_orderintegerOptional
The display order for interests.
idstringOptionalRead-only
The ID for the interest.
list_idstringOptionalRead-only
The ID for the list that this interest belongs to.
namestringOptional
The name of the interest. This can be shown publicly on a subscription form.
subscriber_countstringOptionalRead-only
The number of subscribers associated with this interest.