Skip to navigation
API ReferenceLists

Update interest category

Update a specific interest 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

Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to Group Titles the application.
display_orderintegerOptional
The order that the categories are displayed in the list. Lower numbers display first.
titlestringOptional
The text description of this category. This field appears on signup forms and is often phrased as a question.
typeenumOptional

Determines how this category’s interests appear on signup forms.

Allowed values:

Response

This endpoint returns an object.
display_orderintegerOptional
The order that the categories are displayed in the list. Lower numbers display first.
idstringOptionalRead-only
The id for the interest category.
list_idstringOptionalRead-only
The unique list id for the category.
titlestringOptional
The text description of this category. This field appears on signup forms and is often phrased as a question.
typeenumOptional

Determines how this category’s interests appear on signup forms.

Allowed values: