Skip to navigation
API ReferenceLists

Add interest category

Create a new 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.

Request

Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to Group Titles the application.
titlestringRequired
The text description of this category. This field appears on signup forms and is often phrased as a question.
typeenumRequired

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

Allowed values:
display_orderintegerOptional
The order that the categories are displayed in the list. Lower numbers display first.

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: