LandingPagesUnpublishActiondefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
LandingPagesUpdatePageById200Response
{
"type": "object",
"title": "Landing Page",
"properties": {
"id": {
"type": "string",
"title": "Landing Page ID",
"example": "030092c2e1f0",
"readOnly": true,
"description": "A string that uniquely identifies this landing page."
},
"url": {
"type": "string",
"title": "Published url",
"readOnly": true,
"description": "The url of the published landing page."
},
"name": {
"type": "string",
"title": "Landing Page Name",
"readOnly": false,
"description": "The name of this landing page."
},
"title": {
"type": "string",
"title": "Landing Page title",
"readOnly": false,
"description": "The title of this landing page seen in the browser's title bar."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"status": {
"enum": [
"published",
"unpublished",
"draft"
],
"type": "string",
"title": "Landing Page status",
"readOnly": true,
"description": "The status of this landing page."
},
"web_id": {
"type": "integer",
"title": "Landing Page Web ID",
"description": "The ID used in the Mailchimp web application."
},
"list_id": {
"type": "string",
"title": "Landing Page list id",
"example": "fde02ad86b",
"readOnly": false,
"description": "The list's ID associated with this landing page."
},
"store_id": {
"type": "string",
"title": "Store ID",
"readOnly": false,
"description": "The ID of the store associated with this landing page."
},
"tracking": {
"type": "object",
"title": "Tracking Settings",
"properties": {
"track_with_mailchimp": {
"type": "boolean",
"title": "Track with Mailchimp",
"description": "Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/)."
},
"enable_restricted_data_processing": {
"type": "boolean",
"title": "Enable restricted data processing",
"description": "Google offers restricted data processing in connection with the California Consumer Privacy Act (CCPA) to restrict how Google uses certain identifiers and other data processed in the provision of its services. You can learn more about Google's restricted data processing within Google Ads [here](https://privacy.google.com/businesses/rdp/)."
}
},
"description": "The tracking settings applied to this landing page."
},
"created_at": {
"type": "string",
"title": "Created At",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was created."
},
"updated_at": {
"type": "string",
"title": "Updated_at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was updated at."
},
"description": {
"type": "string",
"title": "Landing Page description",
"readOnly": false,
"description": "The description of this landing page."
},
"template_id": {
"type": "integer",
"title": "Landing Page template_id",
"readOnly": true,
"description": "The template_id of this landing page."
},
"published_at": {
"type": "string",
"title": "Published at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was published."
},
"unpublished_at": {
"type": "string",
"title": "Unpublished at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was unpublished."
},
"created_by_source": {
"type": "string",
"title": "Created By Source",
"readOnly": true,
"description": "Created by mobile or web"
}
},
"description": "A summary of an individual landing page's settings and content."
}
LandingPagesUpdatePageByIdRequest
{
"type": "object",
"title": "Landing Page",
"properties": {
"name": {
"type": "string",
"title": "Landing Page Name",
"description": "The name of this landing page."
},
"title": {
"type": "string",
"title": "Landing Page title",
"description": "The title of this landing page seen in the browser's title bar."
},
"list_id": {
"type": "string",
"title": "Landing Page list id",
"description": "The list's ID associated with this landing page."
},
"store_id": {
"type": "string",
"title": "Store ID",
"description": "The ID of the store associated with this landing page."
},
"tracking": {
"type": "object",
"title": "Tracking Settings",
"properties": {
"track_with_mailchimp": {
"type": "boolean",
"title": "Track with Mailchimp",
"description": "Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/)."
},
"enable_restricted_data_processing": {
"type": "boolean",
"title": "Enable restricted data processing",
"description": "Google offers restricted data processing in connection with the California Consumer Privacy Act (CCPA) to restrict how Google uses certain identifiers and other data processed in the provision of its services. You can learn more about Google's restricted data processing within Google Ads [here](https://privacy.google.com/businesses/rdp/)."
}
},
"description": "The tracking settings applied to this landing page."
},
"description": {
"type": "string",
"title": "Landing Page description",
"description": "The description of this landing page."
}
},
"description": "A summary of an individual page's properties."
}
LandingPagesUpdatePageByIdResponse
{
"type": "object",
"title": "Landing Page",
"properties": {
"id": {
"type": "string",
"title": "Landing Page ID",
"example": "030092c2e1f0",
"readOnly": true,
"description": "A string that uniquely identifies this landing page."
},
"url": {
"type": "string",
"title": "Published url",
"readOnly": true,
"description": "The url of the published landing page."
},
"name": {
"type": "string",
"title": "Landing Page Name",
"readOnly": false,
"description": "The name of this landing page."
},
"title": {
"type": "string",
"title": "Landing Page title",
"readOnly": false,
"description": "The title of this landing page seen in the browser's title bar."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"status": {
"enum": [
"published",
"unpublished",
"draft"
],
"type": "string",
"title": "Landing Page status",
"readOnly": true,
"description": "The status of this landing page."
},
"web_id": {
"type": "integer",
"title": "Landing Page Web ID",
"description": "The ID used in the Mailchimp web application."
},
"list_id": {
"type": "string",
"title": "Landing Page list id",
"example": "fde02ad86b",
"readOnly": false,
"description": "The list's ID associated with this landing page."
},
"store_id": {
"type": "string",
"title": "Store ID",
"readOnly": false,
"description": "The ID of the store associated with this landing page."
},
"tracking": {
"type": "object",
"title": "Tracking Settings",
"properties": {
"track_with_mailchimp": {
"type": "boolean",
"title": "Track with Mailchimp",
"description": "Use cookies to track unique visitors and calculate overall conversion rate. Learn more [here](https://mailchimp.com/help/use-track-mailchimp/)."
},
"enable_restricted_data_processing": {
"type": "boolean",
"title": "Enable restricted data processing",
"description": "Google offers restricted data processing in connection with the California Consumer Privacy Act (CCPA) to restrict how Google uses certain identifiers and other data processed in the provision of its services. You can learn more about Google's restricted data processing within Google Ads [here](https://privacy.google.com/businesses/rdp/)."
}
},
"description": "The tracking settings applied to this landing page."
},
"created_at": {
"type": "string",
"title": "Created At",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was created."
},
"updated_at": {
"type": "string",
"title": "Updated_at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was updated at."
},
"description": {
"type": "string",
"title": "Landing Page description",
"readOnly": false,
"description": "The description of this landing page."
},
"template_id": {
"type": "integer",
"title": "Landing Page template_id",
"readOnly": true,
"description": "The template_id of this landing page."
},
"published_at": {
"type": "string",
"title": "Published at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was published."
},
"unpublished_at": {
"type": "string",
"title": "Unpublished at",
"format": "date-time",
"readOnly": true,
"description": "The time this landing page was unpublished."
},
"created_by_source": {
"type": "string",
"title": "Created By Source",
"readOnly": true,
"description": "Created by mobile or web"
}
},
"description": "A summary of an individual landing page's settings and content."
}
LandingPagesUpdatePageByIddefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddInterestCategory200Response
{
"type": "object",
"title": "Interest Category",
"properties": {
"id": {
"type": "string",
"title": "Category ID",
"readOnly": true,
"description": "The id for the interest category."
},
"type": {
"enum": [
"checkboxes",
"dropdown",
"radio",
"hidden"
],
"type": "string",
"title": "Display Type",
"description": "Determines how this category’s interests appear on signup forms."
},
"title": {
"type": "string",
"title": "Name",
"description": "The text description of this category. This field appears on signup forms and is often phrased as a question."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The unique list id for the category."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the categories are displayed in the list. Lower numbers display first."
}
},
"description": "Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to Group Titles the application."
}
ListsAddInterestCategoryRequest
{
"type": "object",
"title": "Interest Category",
"required": [
"title",
"type"
],
"properties": {
"type": {
"enum": [
"checkboxes",
"dropdown",
"radio",
"hidden"
],
"type": "string",
"title": "Display Type",
"description": "Determines how this category’s interests appear on signup forms."
},
"title": {
"type": "string",
"title": "Name",
"description": "The text description of this category. This field appears on signup forms and is often phrased as a question."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the categories are displayed in the list. Lower numbers display first."
}
},
"description": "Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to Group Titles the application."
}
ListsAddInterestCategoryResponse
{
"type": "object",
"title": "Interest Category",
"properties": {
"id": {
"type": "string",
"title": "Category ID",
"readOnly": true,
"description": "The id for the interest category."
},
"type": {
"enum": [
"checkboxes",
"dropdown",
"radio",
"hidden"
],
"type": "string",
"title": "Display Type",
"description": "Determines how this category’s interests appear on signup forms."
},
"title": {
"type": "string",
"title": "Name",
"description": "The text description of this category. This field appears on signup forms and is often phrased as a question."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The unique list id for the category."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the categories are displayed in the list. Lower numbers display first."
}
},
"description": "Interest categories organize interests, which are used to group subscribers based on their preferences. These correspond to Group Titles the application."
}
ListsAddInterestCategorydefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddInterestInCategory200Response
{
"type": "object",
"title": "Interest",
"properties": {
"id": {
"type": "string",
"title": "Interest ID",
"readOnly": true,
"description": "The ID for the interest."
},
"name": {
"type": "string",
"title": "Interest Name",
"description": "The name of the interest. This can be shown publicly on a subscription form."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The ID for the list that this interest belongs to."
},
"category_id": {
"type": "string",
"title": "Interest Category ID",
"readOnly": true,
"description": "The id for the interest category."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The display order for interests."
},
"subscriber_count": {
"type": "string",
"title": "Subscriber Count",
"readOnly": true,
"description": "The number of subscribers associated with this interest."
}
},
"description": "Assign subscribers to interests to group them together. Interests are referred to as 'group names' in the Mailchimp application."
}
ListsAddInterestInCategoryRequest
{
"type": "object",
"title": "Interest",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Interest Name",
"description": "The name of the interest. This can be shown publicly on a subscription form."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The display order for interests."
}
},
"description": "Assign subscribers to interests to group them together. Interests are referred to as 'group names' in the Mailchimp application."
}
ListsAddInterestInCategoryResponse
{
"type": "object",
"title": "Interest",
"properties": {
"id": {
"type": "string",
"title": "Interest ID",
"readOnly": true,
"description": "The ID for the interest."
},
"name": {
"type": "string",
"title": "Interest Name",
"description": "The name of the interest. This can be shown publicly on a subscription form."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The ID for the list that this interest belongs to."
},
"category_id": {
"type": "string",
"title": "Interest Category ID",
"readOnly": true,
"description": "The id for the interest category."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The display order for interests."
},
"subscriber_count": {
"type": "string",
"title": "Subscriber Count",
"readOnly": true,
"description": "The number of subscribers associated with this interest."
}
},
"description": "Assign subscribers to interests to group them together. Interests are referred to as 'group names' in the Mailchimp application."
}
ListsAddInterestInCategorydefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberEventRequest
{
"type": "object",
"title": "Events",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Event Name",
"description": "The name for this type of event ('purchased', 'visited', etc). Must be 2-30 characters in length"
},
"is_syncing": {
"type": "boolean",
"title": "Is Syncing",
"description": "Events created with the is_syncing value set to `true` will not trigger automations."
},
"properties": {
"type": "object",
"title": "Properties",
"description": "An optional list of properties",
"additionalProperties": {
"type": "string"
}
},
"occurred_at": {
"type": "string",
"title": "Occurred Time",
"format": "date-time",
"description": "The date and time the event occurred in ISO 8601 format."
}
},
"description": "A new event for a specific list member"
}
ListsAddMemberEventResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberEventdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberNote200Response
{
"type": "object",
"title": "Member Notes",
"properties": {
"id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"note": {
"type": "string",
"title": "Note",
"description": "The content of the note."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The unique id for the list."
},
"email_id": {
"type": "string",
"title": "Email Hash",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `email_id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
},
"updated_at": {
"type": "string",
"title": "Updated Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was last updated in ISO 8601 format."
}
},
"description": "A specific note for a specific member."
}
ListsAddMemberNoteRequest
{
"type": "object",
"title": "Member Notes",
"properties": {
"note": {
"type": "string",
"title": "Note",
"description": "The content of the note. Note length is limited to 1,000 characters."
}
},
"description": "A specific note for a specific member."
}
ListsAddMemberNoteResponse
{
"type": "object",
"title": "Member Notes",
"properties": {
"id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"note": {
"type": "string",
"title": "Note",
"description": "The content of the note."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The unique id for the list."
},
"email_id": {
"type": "string",
"title": "Email Hash",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `email_id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
},
"updated_at": {
"type": "string",
"title": "Updated Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was last updated in ISO 8601 format."
}
},
"description": "A specific note for a specific member."
}
ListsAddMemberNotedefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberTagsRequest
{
"type": "object",
"title": "Member Tags",
"required": [
"tags"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "object",
"title": "Member Tag",
"required": [
"name",
"status"
],
"properties": {
"name": {
"type": "string",
"title": "Tag Name",
"description": "The name of the tag."
},
"status": {
"enum": [
"inactive",
"active"
],
"type": "string",
"title": "Status",
"description": "The status for the tag on the member, pass in active to add a tag or inactive to remove it."
}
},
"description": "Add or remove tags on a member by declaring a tag either active or inactive on a member."
},
"title": "Tags",
"description": "A list of tags assigned to the list member."
},
"is_syncing": {
"type": "boolean",
"title": "Is Syncing",
"description": "When is_syncing is true, automations based on the tags in the request will not fire"
}
},
"description": "A list of tags assigned to a list member."
}
ListsAddMemberTagsResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberTagsdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberToList200Response
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "Returns up to 50 tags applied to this member. To retrieve all tags see [Member Tags](https://mailchimp.com/developer/marketing/api/list-member-tags/)."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
},
"ecommerce_data": {
"type": "object",
"title": "Ecommerce Stats",
"readOnly": true,
"properties": {
"currency_code": {
"type": "string",
"title": "Currency",
"example": "USD",
"readOnly": true,
"description": "The three-letter ISO 4217 code for the currency that the store accepts."
},
"total_revenue": {
"type": "number",
"title": "Total Revenue",
"readOnly": true,
"description": "The total revenue the list member has brought in."
},
"number_of_orders": {
"type": "number",
"title": "Total Number of Orders",
"readOnly": true,
"description": "The total number of orders placed by the list member."
}
},
"description": "Ecommerce stats for the list member if the list is attached to a store."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"source": {
"type": "string",
"title": "Subscriber Source",
"readOnly": true,
"description": "The source from which the subscriber was added to this list."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional",
"archived"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"web_id": {
"type": "integer",
"title": "Member Web ID",
"readOnly": true,
"description": "The ID used in the Mailchimp web application. View this member in your Mailchimp account at `https://{dc}.admin.mailchimp.com/lists/members/view?id={web_id}`."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"region": {
"type": "string",
"title": "Region",
"readOnly": true,
"description": "The region for the location."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"full_name": {
"type": "string",
"title": "Full Name",
"readOnly": true,
"description": "The contact's full name."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"sms_phone_number": {
"type": "string",
"title": "SMS Phone Number",
"description": "A US phone number for SMS contact."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"unsubscribe_reason": {
"type": "string",
"title": "Unsubscribe Reason",
"description": "A subscriber's reason for unsubscribing."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"text": {
"type": "string",
"title": "Marketing Permission Text",
"description": "The text of the marketing permission."
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
},
"sms_subscription_status": {
"enum": [
"subscribed",
"unsubscribed",
"nonsubscribed",
"pending"
],
"type": "string",
"title": "SMS Subscription Status",
"description": "The status of an SMS subscription."
},
"sms_subscription_last_updated": {
"type": "string",
"title": "SMS Subscription Last Update",
"description": "The datetime when the SMS subscription was last updated"
},
"consents_to_one_to_one_messaging": {
"type": "boolean",
"title": "Messaging Consent",
"readOnly": true,
"description": "Indicates whether a contact consents to 1:1 messaging."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddMemberToListRequest
{
"type": "object",
"title": "Add List Members",
"required": [
"email_address",
"status"
],
"properties": {
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "string",
"description": "The name of the tag that will be associated with this member."
},
"title": "Tags on a member",
"description": "The tags that are associated with a member."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"description": "IP address the subscriber signed up from."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddMemberToListResponse
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "Returns up to 50 tags applied to this member. To retrieve all tags see [Member Tags](https://mailchimp.com/developer/marketing/api/list-member-tags/)."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
},
"ecommerce_data": {
"type": "object",
"title": "Ecommerce Stats",
"readOnly": true,
"properties": {
"currency_code": {
"type": "string",
"title": "Currency",
"example": "USD",
"readOnly": true,
"description": "The three-letter ISO 4217 code for the currency that the store accepts."
},
"total_revenue": {
"type": "number",
"title": "Total Revenue",
"readOnly": true,
"description": "The total revenue the list member has brought in."
},
"number_of_orders": {
"type": "number",
"title": "Total Number of Orders",
"readOnly": true,
"description": "The total number of orders placed by the list member."
}
},
"description": "Ecommerce stats for the list member if the list is attached to a store."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"source": {
"type": "string",
"title": "Subscriber Source",
"readOnly": true,
"description": "The source from which the subscriber was added to this list."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional",
"archived"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"web_id": {
"type": "integer",
"title": "Member Web ID",
"readOnly": true,
"description": "The ID used in the Mailchimp web application. View this member in your Mailchimp account at `https://{dc}.admin.mailchimp.com/lists/members/view?id={web_id}`."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"region": {
"type": "string",
"title": "Region",
"readOnly": true,
"description": "The region for the location."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"full_name": {
"type": "string",
"title": "Full Name",
"readOnly": true,
"description": "The contact's full name."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"sms_phone_number": {
"type": "string",
"title": "SMS Phone Number",
"description": "A US phone number for SMS contact."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"unsubscribe_reason": {
"type": "string",
"title": "Unsubscribe Reason",
"description": "A subscriber's reason for unsubscribing."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"text": {
"type": "string",
"title": "Marketing Permission Text",
"description": "The text of the marketing permission."
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
},
"sms_subscription_status": {
"enum": [
"subscribed",
"unsubscribed",
"nonsubscribed",
"pending"
],
"type": "string",
"title": "SMS Subscription Status",
"description": "The status of an SMS subscription."
},
"sms_subscription_last_updated": {
"type": "string",
"title": "SMS Subscription Last Update",
"description": "The datetime when the SMS subscription was last updated"
},
"consents_to_one_to_one_messaging": {
"type": "boolean",
"title": "Messaging Consent",
"readOnly": true,
"description": "Indicates whether a contact consents to 1:1 messaging."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddMemberToListdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMemberToSegment200Response
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"readOnly": true,
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddMemberToSegmentRequest
{
"type": "object",
"required": [
"email_address"
],
"properties": {
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
}
}
}
ListsAddMemberToSegmentResponse
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"readOnly": true,
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddMemberToSegmentdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddMergeField200Response
{
"type": "object",
"title": "Merge Field",
"properties": {
"tag": {
"type": "string",
"title": "Merge Tag",
"description": "The merge tag used for Mailchimp campaigns and [adding contact information](https://mailchimp.com/developer/marketing/docs/merge-fields/#add-merge-data-to-contacts)."
},
"name": {
"type": "string",
"title": "Merge Field Name",
"description": "The name of the merge field (audience field)."
},
"type": {
"enum": [
"text",
"number",
"address",
"phone",
"date",
"url",
"imageurl",
"radio",
"dropdown",
"birthday",
"zip"
],
"type": "string",
"title": "Merge Field Type",
"readOnly": true,
"description": "The [type](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for the merge field."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"public": {
"type": "boolean",
"title": "Merge Field Public Status",
"description": "Whether the merge field is displayed on the signup form."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The ID that identifies this merge field's audience'."
},
"options": {
"type": "object",
"title": "Merge Field Options",
"properties": {
"size": {
"type": "integer",
"title": "Text Field Size",
"readOnly": true,
"description": "In a text field, the default length of the text field."
},
"choices": {
"type": "array",
"items": {
"type": "string"
},
"title": "Choices",
"example": [
"First Choice",
"Second Choice",
"Third Choice"
],
"description": "In a radio or dropdown non-group field, the available options for contacts to pick from."
},
"date_format": {
"type": "string",
"title": "Date Type",
"description": "In a date or birthday field, the format of the date."
},
"phone_format": {
"type": "string",
"title": "Phone Type",
"description": "In a phone field, the phone number type: US or International."
},
"default_country": {
"type": "integer",
"title": "Default Country",
"description": "In an address field, the default country code if none supplied."
}
},
"description": "Extra options for some merge field types."
},
"merge_id": {
"type": "integer",
"title": "Merge Field ID",
"readOnly": true,
"description": "An unchanging id for the merge field."
},
"required": {
"type": "boolean",
"title": "Required",
"description": "The boolean value if the merge field is required."
},
"help_text": {
"type": "string",
"title": "Merge Field Help Text",
"description": "Extra text to help the subscriber fill out the form."
},
"default_value": {
"type": "string",
"title": "Default Value",
"description": "The default value for the merge field if `null`."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the merge field displays on the list signup form."
}
},
"description": "A [merge field](https://mailchimp.com/developer/marketing/docs/merge-fields/) for an audience."
}
ListsAddMergeFieldRequest
{
"type": "object",
"title": "Merge Field",
"required": [
"name",
"type"
],
"properties": {
"tag": {
"type": "string",
"title": "Merge Tag",
"description": "The merge tag used for Mailchimp campaigns and [adding contact information](https://mailchimp.com/developer/marketing/docs/merge-fields/#add-merge-data-to-contacts)."
},
"name": {
"type": "string",
"title": "Merge Field Name",
"description": "The name of the merge field (audience field)."
},
"type": {
"enum": [
"text",
"number",
"address",
"phone",
"date",
"url",
"imageurl",
"radio",
"dropdown",
"birthday",
"zip"
],
"type": "string",
"title": "Merge Field Type",
"description": "The [type](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for the merge field."
},
"public": {
"type": "boolean",
"title": "Merge Field Public Status",
"description": "Whether the merge field is displayed on the signup form."
},
"options": {
"type": "object",
"title": "Merge Field Options",
"properties": {
"size": {
"type": "integer",
"title": "Text Field Size",
"description": "In a text field, the default length of the text field."
},
"choices": {
"type": "array",
"items": {
"type": "string"
},
"title": "Choices",
"example": [
"First Choice",
"Second Choice",
"Third Choice"
],
"description": "In a radio or dropdown non-group field, the available options for contacts to pick from."
},
"date_format": {
"type": "string",
"title": "Date Type",
"description": "In a date or birthday field, the format of the date."
},
"phone_format": {
"type": "string",
"title": "Phone Type",
"description": "In a phone field, the phone number type: US or International."
},
"default_country": {
"type": "integer",
"items": {
"type": "string"
},
"title": "Default Country",
"description": "In an address field, the default country code if none supplied."
}
},
"description": "Extra options for some merge field types."
},
"required": {
"type": "boolean",
"title": "Required",
"description": "Whether the merge field is required to import a contact."
},
"help_text": {
"type": "string",
"title": "Merge Field Help Text",
"description": "Extra text to help the subscriber fill out the form."
},
"default_value": {
"type": "string",
"title": "Default Value",
"description": "The default value for the merge field if `null`."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the merge field displays on the list signup form."
}
},
"description": "A [merge field](https://mailchimp.com/developer/marketing/docs/merge-fields/) for an audience."
}
ListsAddMergeFieldResponse
{
"type": "object",
"title": "Merge Field",
"properties": {
"tag": {
"type": "string",
"title": "Merge Tag",
"description": "The merge tag used for Mailchimp campaigns and [adding contact information](https://mailchimp.com/developer/marketing/docs/merge-fields/#add-merge-data-to-contacts)."
},
"name": {
"type": "string",
"title": "Merge Field Name",
"description": "The name of the merge field (audience field)."
},
"type": {
"enum": [
"text",
"number",
"address",
"phone",
"date",
"url",
"imageurl",
"radio",
"dropdown",
"birthday",
"zip"
],
"type": "string",
"title": "Merge Field Type",
"readOnly": true,
"description": "The [type](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for the merge field."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"public": {
"type": "boolean",
"title": "Merge Field Public Status",
"description": "Whether the merge field is displayed on the signup form."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The ID that identifies this merge field's audience'."
},
"options": {
"type": "object",
"title": "Merge Field Options",
"properties": {
"size": {
"type": "integer",
"title": "Text Field Size",
"readOnly": true,
"description": "In a text field, the default length of the text field."
},
"choices": {
"type": "array",
"items": {
"type": "string"
},
"title": "Choices",
"example": [
"First Choice",
"Second Choice",
"Third Choice"
],
"description": "In a radio or dropdown non-group field, the available options for contacts to pick from."
},
"date_format": {
"type": "string",
"title": "Date Type",
"description": "In a date or birthday field, the format of the date."
},
"phone_format": {
"type": "string",
"title": "Phone Type",
"description": "In a phone field, the phone number type: US or International."
},
"default_country": {
"type": "integer",
"title": "Default Country",
"description": "In an address field, the default country code if none supplied."
}
},
"description": "Extra options for some merge field types."
},
"merge_id": {
"type": "integer",
"title": "Merge Field ID",
"readOnly": true,
"description": "An unchanging id for the merge field."
},
"required": {
"type": "boolean",
"title": "Required",
"description": "The boolean value if the merge field is required."
},
"help_text": {
"type": "string",
"title": "Merge Field Help Text",
"description": "Extra text to help the subscriber fill out the form."
},
"default_value": {
"type": "string",
"title": "Default Value",
"description": "The default value for the merge field if `null`."
},
"display_order": {
"type": "integer",
"title": "Display Order",
"description": "The order that the merge field displays on the list signup form."
}
},
"description": "A [merge field](https://mailchimp.com/developer/marketing/docs/merge-fields/) for an audience."
}
ListsAddMergeFielddefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddNewSegment200Response
{
"type": "object",
"title": "List",
"properties": {
"id": {
"type": "integer",
"title": "Segment ID",
"readOnly": true,
"description": "The unique id for the segment."
},
"name": {
"type": "string",
"title": "Segment Name",
"description": "The name of the segment."
},
"type": {
"enum": [
"saved",
"static",
"fuzzy"
],
"type": "string",
"title": "Type",
"readOnly": true,
"description": "The type of segment. Static segments are now known as tags. Learn more about [tags](https://mailchimp.com/help/getting-started-tags?utm_source=mc-api&utm_medium=docs&utm_campaign=apidocs)."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"options": {
"type": "object",
"title": "Conditions",
"properties": {
"match": {
"enum": [
"any",
"all"
],
"type": "string",
"title": "Match",
"description": "Match type."
},
"conditions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"title": "Aim Segment",
"properties": {
"op": {
"enum": [
"open",
"click",
"sent",
"noopen",
"noclick",
"nosent"
],
"type": "string",
"title": "Segment Operator",
"example": "open",
"description": "The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn't open, didn't click, or was not sent."
},
"field": {
"enum": [
"aim"
],
"type": "string",
"title": "Segment Field",
"example": "aim",
"description": "Segment by interaction with a specific campaign."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Aim"
],
"type": "string",
"x-value": "Aim"
}
},
"description": "Segment by interaction with a specific campaign."
},
{
"type": "object",
"title": "Automation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow."
},
"field": {
"enum": [
"automation"
],
"type": "string",
"title": "Segment Field",
"example": "automation",
"description": "Segment by interaction with an Automation workflow."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "2135217",
"description": "The web id for the automation workflow to segment against."
},
"condition_type": {
"enum": [
"Automation"
],
"type": "string",
"x-value": "Automation"
}
},
"description": "Segment by interaction with an Automation workflow."
},
{
"type": "object",
"title": "Poll Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members have/have not interacted with a specific poll in a Mailchimp email."
},
"field": {
"enum": [
"poll"
],
"type": "string",
"title": "Segment Field",
"example": "poll",
"description": "Segment by poll activity."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 409,
"description": "The id for the poll."
},
"condition_type": {
"enum": [
"CampaignPoll"
],
"type": "string",
"x-value": "CampaignPoll"
}
},
"description": "Segment by poll activity."
},
{
"type": "object",
"title": "Conversation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "The status of a member's interaction with a conversation. One of the following: has replied or has not replied."
},
"field": {
"enum": [
"conversation"
],
"type": "string",
"title": "Segment Field",
"example": "conversation",
"description": "Segment by interaction with a campaign via Conversations."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Conversation"
],
"type": "string",
"x-value": "Conversation"
}
},
"description": "Segment by interaction with a campaign via Conversations."
},
{
"type": "object",
"title": "Date Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is",
"not",
"blank",
"blank_not",
"within",
"notwithin"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "When the event took place: Before, after, is a specific date, is not a specific date, is blank, or is not blank."
},
"extra": {
"type": "string",
"title": "Segment Extra Value",
"example": "2015-01-30",
"description": "When segmenting on 'date' or 'campaign', the date for the segment formatted as YYYY-MM-DD or the web id for the campaign."
},
"field": {
"enum": [
"timestamp_opt",
"info_changed",
"ecomm_date"
],
"type": "string",
"title": "Segment Field",
"example": "timestamp_opt",
"description": "The type of date field to segment on: The opt-in time for a signup, the date the subscriber was last updated, or the date of their last ecomm purchase."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "date",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"Date"
],
"type": "string",
"x-value": "Date"
}
},
"description": "Segment by a specific date field."
},
{
"type": "object",
"title": "Email Client Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"client_is",
"client_not"
],
"type": "string",
"title": "Segment Operator",
"example": "client_is",
"description": "The operation to determine whether we select clients that match the value, or clients that do not match the value."
},
"field": {
"enum": [
"email_client"
],
"type": "string",
"title": "Segment Field",
"example": "email_client",
"description": "Segment by use of a particular email client."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Gmail",
"description": "The name of the email client."
},
"condition_type": {
"enum": [
"EmailClient"
],
"type": "string",
"x-value": "EmailClient"
}
},
"description": "Segment by use of a particular email client."
},
{
"type": "object",
"title": "Language Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's language is or is not set to a specific language."
},
"field": {
"enum": [
"language"
],
"type": "string",
"title": "Segment Field",
"example": "language",
"description": "Segmenting based off of a subscriber's language."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "en",
"description": "A two-letter language identifier."
},
"condition_type": {
"enum": [
"Language"
],
"type": "string",
"x-value": "Language"
}
},
"description": "Segment by language."
},
{
"type": "object",
"title": "Member Rating Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have have a rating that is/not exactly a given number or members who have a rating greater/less than a given number."
},
"field": {
"enum": [
"rating"
],
"type": "string",
"title": "Segment Field",
"example": "rating",
"description": "Segment by member rating."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 4,
"description": "The star rating number to segment against."
},
"condition_type": {
"enum": [
"MemberRating"
],
"type": "string",
"x-value": "MemberRating"
}
},
"description": "Segment by member rating."
},
{
"type": "object",
"title": "Signup Source Segment",
"required": [
"field",
"condition_type",
"op"
],
"properties": {
"op": {
"enum": [
"source_is",
"source_not"
],
"type": "string",
"title": "Segment Operator",
"example": "source_is",
"description": "Whether the member's signup source was/was not a particular value."
},
"field": {
"enum": [
"source"
],
"type": "string",
"title": "Segment Field",
"example": "source"
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "List Import",
"description": "The signup source."
},
"condition_type": {
"enum": [
"SignupSource"
],
"type": "string",
"title": "Type",
"x-value": "SignupSource"
}
},
"description": "Segment by signup source."
},
{
"type": "object",
"title": "Survey Monkey Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the survey.One of the following: has started the survey, has completed the survey, has not started the survey, or has not completed the survey."
},
"field": {
"enum": [
"survey_monkey"
],
"type": "string",
"title": "Segment Field",
"example": "survey_monkey",
"description": "Segment by interaction with a SurveyMonkey survey."
},
"value": {
"type": "string",
"title": "Survey ID",
"example": "32179586",
"description": "The unique ID of the survey monkey survey."
},
"condition_type": {
"enum": [
"SurveyMonkey"
],
"type": "string",
"x-value": "SurveyMonkey"
}
},
"description": "Segment by interaction with a SurveyMonkey survey."
},
{
"type": "object",
"title": "VIP Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Whether the member is or is not marked as VIP."
},
"field": {
"enum": [
"gmonkey"
],
"type": "string",
"title": "Segment Field",
"example": "gmonkey",
"description": "Segment by VIP status."
},
"condition_type": {
"enum": [
"VIP"
],
"type": "string",
"x-value": "VIP"
}
},
"description": "Segment by VIP status."
},
{
"type": "object",
"title": "Interests Segment",
"properties": {
"op": {
"enum": [
"interestcontains",
"interestcontainsall",
"interestnotcontains"
],
"type": "string",
"title": "Segment Operator",
"example": "interestcontains",
"description": "Whether the member is a part of one, all, or none of the groups."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "interests-123",
"description": "Segmenting based on interest group information. This should start with 'interests-' followed by the grouping id. Ex. 'interests-123'."
},
"value": {
"type": "array",
"items": {
"type": "string",
"example": [
"44401",
"44405",
"44409"
]
},
"title": "Segment Value",
"description": "An array containing strings, each representing a group id."
},
"condition_type": {
"enum": [
"Interests"
],
"type": "string",
"x-value": "Interests"
}
},
"description": "Segment by an interest group merge field."
},
{
"type": "object",
"title": "Ecommerce Category Segment",
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "A member who has purchased from a category/specific item that is/is not a specific name, where the category/item name contains/doesn't contain a specific phrase or string, or a category/item name that starts/ends with a string."
},
"field": {
"enum": [
"ecomm_cat",
"ecomm_prod"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_cat",
"description": "Segment by purchases in specific items or categories."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Product",
"description": "The ecommerce category/item information."
},
"condition_type": {
"enum": [
"EcommCategory"
],
"type": "string",
"x-value": "EcommCategory"
}
},
"description": "Segment by purchases in specific items or categories."
},
{
"type": "object",
"title": "Ecommerce Number Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than the segment value."
},
"field": {
"enum": [
"ecomm_spent_avg",
"ecomm_orders",
"ecomm_prod_all",
"ecomm_avg_ord"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_orders",
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 42,
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than this amount."
},
"condition_type": {
"enum": [
"EcommNumber"
],
"type": "string",
"x-value": "EcommNumber"
}
},
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
{
"type": "object",
"title": "Ecommerce Purchased Segment",
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who have have ('member') or have not ('notmember') purchased."
},
"field": {
"enum": [
"ecomm_purchased"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_purchased",
"description": "Segment by whether someone has purchased anything."
},
"condition_type": {
"enum": [
"EcommPurchased"
],
"type": "string",
"x-value": "EcommPurchased"
}
},
"description": "Segment by whether someone has purchased anything."
},
{
"type": "object",
"title": "Ecommerce Spent Segment",
"properties": {
"op": {
"enum": [
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent 'more' or 'less' than then specified value."
},
"field": {
"enum": [
"ecomm_spent_one",
"ecomm_spent_all"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_spent_one",
"description": "Segment by amount spent on a single order or across all orders."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The total amount a member spent."
},
"condition_type": {
"enum": [
"EcommSpent"
],
"type": "string",
"x-value": "EcommSpent"
}
},
"description": "Segment by amount spent on a single order or across all orders."
},
{
"type": "object",
"title": "Ecommerce Purchased Store Segment",
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who have or have not purchased from a specific store."
},
"field": {
"enum": [
"ecomm_store"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_store",
"description": "Segment by purchases from a specific store."
},
"value": {
"type": "string",
"title": "Segment Operator",
"example": "289",
"description": "The store id to segment against."
},
"condition_type": {
"enum": [
"EcommStore"
],
"type": "string",
"x-value": "EcommStore"
}
},
"description": "Segment by purchases from a specific store."
},
{
"type": "object",
"title": "Goal Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"goal_not",
"contains",
"goal_notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the website URL is/not exactly, contains/doesn't contain, starts with/ends with a string."
},
"field": {
"enum": [
"goal"
],
"type": "string",
"title": "Segment Field",
"example": "goal",
"description": "Segment by Goal activity."
},
"value": {
"type": "string",
"title": "Segment Value",
"description": "The URL to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalActivity"
],
"type": "string",
"x-value": "GoalActivity"
}
},
"description": "Segment by Goal activity."
},
{
"type": "object",
"title": "Goal Timestamp Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Whether the website activity happened after, before, or at a given timestamp."
},
"field": {
"enum": [
"goal_last_visited"
],
"type": "string",
"title": "Segment Field",
"example": "goal_last_visited",
"description": "Segment by most recent interaction with a website."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "2015-07-20 19:45:21",
"description": "The date to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalTimestamp"
],
"type": "string",
"x-value": "GoalTimestamp"
}
},
"description": "Segment by most recent interaction with a website."
},
{
"type": "object",
"title": "Similar Subscribers Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"fuzzy_is",
"fuzzy_not"
],
"type": "string",
"title": "Segment Operator",
"example": "fuzzy_is",
"description": "Members who are/are not apart of a 'similar subscribers' segment."
},
"field": {
"enum": [
"fuzzy_segment"
],
"type": "string",
"title": "Segment Field",
"example": "fuzzy_segment",
"description": "Segment by similar subscribers."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the 'similar subscribers' segment."
},
"condition_type": {
"enum": [
"FuzzySegment"
],
"type": "string",
"x-value": "FuzzySegment"
}
},
"description": "Segment by similar subscribers."
},
{
"type": "object",
"title": "Static Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"static_is",
"static_not"
],
"type": "string",
"title": "Segment Operator",
"example": "static_is",
"description": "Members who are/are not apart of a static segment."
},
"field": {
"enum": [
"static_segment"
],
"type": "string",
"title": "Segment Field",
"example": "static_segment",
"description": "Segment by a given static segment."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the static segment."
},
"condition_type": {
"enum": [
"StaticSegment"
],
"type": "string",
"x-value": "StaticSegment"
}
},
"description": "Segment by a given static segment."
},
{
"type": "object",
"title": "Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeocountry",
"ipgeonotcountry",
"ipgeostate",
"ipgeonotstate"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeocountry",
"description": "Segment members who are within a specific country or US state."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "US",
"description": "The two-letter country code or US state abbreviation."
},
"condition_type": {
"enum": [
"IPGeoCountryState"
],
"type": "string",
"x-value": "IPGeoCountryState"
}
},
"description": "Segment by a specific country or US state."
},
{
"type": "object",
"title": "Geolocation Segment",
"required": [
"field",
"op",
"value",
"addr",
"lat",
"lng"
],
"properties": {
"op": {
"enum": [
"ipgeoin",
"ipgeonotin"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoin",
"description": "Segment members who are within a specific geographic region."
},
"lat": {
"type": "string",
"title": "Segment Location Latitude",
"example": "33.7489954",
"description": "The latitude of the target location."
},
"lng": {
"type": "string",
"title": "Segment Location Longitude",
"example": "-84.3879824",
"description": "The longitude of the target location."
},
"addr": {
"type": "string",
"title": "Segment Location Address",
"example": "Atlanta, GA, USA",
"description": "The address of the target location."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoIn"
],
"type": "string",
"x-value": "IPGeoIn"
}
},
"description": "Segment by a specific geographic region."
},
{
"type": "object",
"title": "US Zip Code Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"ipgeoinzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoinzip",
"description": "Segment members who are within a specific US zip code."
},
"extra": {
"type": "integer",
"title": "Extra Data",
"example": 30318,
"description": "The zip code to segment against."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 25,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoInZip"
],
"type": "string",
"x-value": "IPGeoInZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Unknown Location-Based Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"ipgeounknown"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeounknown",
"description": "Segment members for which location information is unknown."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"condition_type": {
"enum": [
"IPGeoUnknown"
],
"type": "string",
"x-value": "IPGeoUnknown"
}
},
"description": "Segment members whose location information is unknown."
},
{
"type": "object",
"title": "Zip Code Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeoiszip",
"ipgeonotzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeonotzip",
"description": "Segment members who are/are not within a specific US zip code."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 30318,
"description": "The 5-digit zip code."
},
"condition_type": {
"enum": [
"IPGeoZip"
],
"type": "string",
"x-value": "IPGeoZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Social Profiles Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_age"
],
"type": "string",
"title": "Segment Field",
"example": "social_age",
"description": "Segment by age ranges in Social Profiles data."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-54",
"55+"
],
"type": "string",
"title": "Segment Operator",
"example": "35-54",
"description": "The age range to segment."
},
"condition_type": {
"enum": [
"SocialAge"
],
"type": "string",
"x-value": "SocialAge"
}
},
"description": "Segment by age ranges in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_gender"
],
"type": "string",
"title": "Segment Field",
"example": "social_gender",
"description": "Segment by listed gender in Social Profiles data."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The Social Profiles gender to segment."
},
"condition_type": {
"enum": [
"SocialGender"
],
"type": "string",
"x-value": "SocialGender"
}
},
"description": "Segment by listed gender in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Influence Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have a rating that is/not or greater/less than the rating provided."
},
"field": {
"enum": [
"social_influence"
],
"type": "string",
"title": "Segment Field",
"example": "social_influence",
"description": "Segment by influence rating in Social Profiles data."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 2,
"description": "The Social Profiles influence rating to segment."
},
"condition_type": {
"enum": [
"SocialInfluence"
],
"type": "string",
"x-value": "SocialInfluence"
}
},
"description": "Segment by influence rating in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who are/not on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter",
"facebook",
"linkedin",
"flickr",
"foursquare",
"lastfm",
"myspace",
"quora",
"vimeo",
"yelp",
"youtube"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkMember"
],
"type": "string",
"x-value": "SocialNetworkMember"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Follow Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"follow",
"notfollow"
],
"type": "string",
"title": "Segment Operator",
"example": "follow",
"description": "Members who are/not following a linked account on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter_follow"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter_follow",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkFollow"
],
"type": "string",
"x-value": "SocialNetworkFollow"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Address Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"contains",
"notcontain",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's address merge field contains/does not contain a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE3",
"description": "An address-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Atlanta",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"AddressMerge"
],
"type": "string",
"x-value": "AddressMerge"
}
},
"description": "Segment by an address-type merge field."
},
{
"type": "object",
"title": "Address/Zip Merge Field Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"geoin"
],
"type": "string",
"title": "Segment Operator",
"example": "geoin",
"description": "Whether the member's address merge field is within a given distance from a city or zip."
},
"extra": {
"type": "string",
"title": "Segment Extra",
"example": "30318",
"description": "The city or the zip being used to segment against."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE2",
"description": "An address or zip-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "25",
"description": "The distance from the city/zip."
},
"condition_type": {
"enum": [
"ZipMerge"
],
"type": "string",
"x-value": "ZipMerge"
}
},
"description": "Segment by an address-type merge field within a given distance."
},
{
"type": "object",
"title": "Birthday Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's birthday merge information is/is not a certain date or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE4",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30",
"description": "A date to segment against (mm/dd)."
},
"condition_type": {
"enum": [
"BirthdayMerge"
],
"type": "string",
"x-value": "BirthdayMerge"
}
},
"description": "Segment by a contact's birthday."
},
{
"type": "object",
"title": "Date Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"less",
"blank",
"blank_not",
"greater"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not, is greater/less than a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE5",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30/2015",
"description": "A date to segment against."
},
"condition_type": {
"enum": [
"DateMerge"
],
"type": "string",
"x-value": "DateMerge"
}
},
"description": "Segment by a given date merge field."
},
{
"type": "object",
"title": "Dropdown/Radio Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not",
"notcontain",
"contains"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE6",
"description": "A merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Second Choice",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"SelectMerge"
],
"type": "string",
"x-value": "SelectMerge"
}
},
"description": "An individual segment condition"
},
{
"type": "object",
"title": "Text or Number Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's merge information is/is not, contains/does not contain, starts/ends with, or is greater/less than a value"
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE7",
"description": "A text or number merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Freddie's Jokes",
"description": "The value to segment a text or number merge field with."
},
"condition_type": {
"enum": [
"TextMerge"
],
"type": "string",
"x-value": "TextMerge"
}
},
"description": "Segment by a given text or number merge field."
},
{
"type": "object",
"title": "Email Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"description": "Whether the email address is/not exactly, contains/doesn't contain, starts/ends with a string."
},
"field": {
"enum": [
"merge0",
"EMAIL"
],
"type": "string",
"title": "Segment Field",
"example": "EMAIL",
"description": "Segmenting based off of a subscriber's email address."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "urist.mcvankab@freddiesjokes.com",
"description": "The value to compare the email against."
},
"condition_type": {
"enum": [
"EmailAddress"
],
"type": "string",
"x-value": "EmailAddress"
}
},
"description": "Segment by email address."
},
{
"type": "object",
"title": "Predicted Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_gender"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted gender."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted gender to segment."
},
"condition_type": {
"enum": [
"PredictedGender"
],
"type": "string",
"x-value": "PredictedGender"
}
},
"description": "Segment by predicted gender."
},
{
"type": "object",
"title": "Predicted Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_age_range"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted age."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-44",
"45-54",
"55-64",
"65+"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted age to segment."
},
"condition_type": {
"enum": [
"PredictedAge"
],
"type": "string",
"x-value": "PredictedAge"
}
},
"description": "Segment by predicted age."
},
{
"type": "object",
"title": "New Subscribers Prebuilt Segment",
"properties": {
"op": {
"enum": [
"date_within"
],
"type": "string",
"title": "Segment Operator",
"description": "Whe the event took place, namely within a time frame."
},
"field": {
"enum": [
"timestamp_opt"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by when people subscribed."
},
"value": {
"type": "string",
"title": "Segment Data",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"NewSubscribers"
],
"type": "string",
"x-value": "NewSubscribers"
}
},
"description": "Segment by when people subscribed."
}
],
"discriminator": {
"type": "string",
"propertyName": "condition_type"
}
},
"title": "Segment Type",
"description": "Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas)."
}
},
"description": "The conditions of the segment. Static segments (tags) and fuzzy segments don't have conditions."
},
"created_at": {
"type": "string",
"title": "Date Created",
"format": "date-time",
"readOnly": true,
"description": "The date and time the segment was created in ISO 8601 format."
},
"updated_at": {
"type": "string",
"title": "Date Updated",
"format": "date-time",
"readOnly": true,
"description": "The date and time the segment was last updated in ISO 8601 format."
},
"member_count": {
"type": "integer",
"title": "Member Count",
"readOnly": true,
"description": "The number of active subscribers currently included in the segment."
}
},
"description": "Information about a specific segment."
}
ListsAddNewSegmentRequest
{
"type": "object",
"title": "List",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Segment Name",
"description": "The name of the segment."
},
"options": {
"type": "object",
"title": "Conditions",
"properties": {
"match": {
"enum": [
"any",
"all"
],
"type": "string",
"title": "Match",
"description": "Match type."
},
"conditions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"title": "Aim Segment",
"properties": {
"op": {
"enum": [
"open",
"click",
"sent",
"noopen",
"noclick",
"nosent"
],
"type": "string",
"title": "Segment Operator",
"example": "open",
"description": "The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn't open, didn't click, or was not sent."
},
"field": {
"enum": [
"aim"
],
"type": "string",
"title": "Segment Field",
"example": "aim",
"description": "Segment by interaction with a specific campaign."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Aim"
],
"type": "string",
"x-value": "Aim"
}
},
"description": "Segment by interaction with a specific campaign."
},
{
"type": "object",
"title": "Automation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow."
},
"field": {
"enum": [
"automation"
],
"type": "string",
"title": "Segment Field",
"example": "automation",
"description": "Segment by interaction with an Automation workflow."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "2135217",
"description": "The web id for the automation workflow to segment against."
},
"condition_type": {
"enum": [
"Automation"
],
"type": "string",
"x-value": "Automation"
}
},
"description": "Segment by interaction with an Automation workflow."
},
{
"type": "object",
"title": "Poll Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members have/have not interacted with a specific poll in a Mailchimp email."
},
"field": {
"enum": [
"poll"
],
"type": "string",
"title": "Segment Field",
"example": "poll",
"description": "Segment by poll activity."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 409,
"description": "The id for the poll."
},
"condition_type": {
"enum": [
"CampaignPoll"
],
"type": "string",
"x-value": "CampaignPoll"
}
},
"description": "Segment by poll activity."
},
{
"type": "object",
"title": "Conversation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "The status of a member's interaction with a conversation. One of the following: has replied or has not replied."
},
"field": {
"enum": [
"conversation"
],
"type": "string",
"title": "Segment Field",
"example": "conversation",
"description": "Segment by interaction with a campaign via Conversations."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Conversation"
],
"type": "string",
"x-value": "Conversation"
}
},
"description": "Segment by interaction with a campaign via Conversations."
},
{
"type": "object",
"title": "Date Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is",
"not",
"blank",
"blank_not",
"within",
"notwithin"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "When the event took place: Before, after, is a specific date, is not a specific date, is blank, or is not blank."
},
"extra": {
"type": "string",
"title": "Segment Extra Value",
"example": "2015-01-30",
"description": "When segmenting on 'date' or 'campaign', the date for the segment formatted as YYYY-MM-DD or the web id for the campaign."
},
"field": {
"enum": [
"timestamp_opt",
"info_changed",
"ecomm_date"
],
"type": "string",
"title": "Segment Field",
"example": "timestamp_opt",
"description": "The type of date field to segment on: The opt-in time for a signup, the date the subscriber was last updated, or the date of their last ecomm purchase."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "date",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"Date"
],
"type": "string",
"x-value": "Date"
}
},
"description": "Segment by a specific date field."
},
{
"type": "object",
"title": "Email Client Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"client_is",
"client_not"
],
"type": "string",
"title": "Segment Operator",
"example": "client_is",
"description": "The operation to determine whether we select clients that match the value, or clients that do not match the value."
},
"field": {
"enum": [
"email_client"
],
"type": "string",
"title": "Segment Field",
"example": "email_client",
"description": "Segment by use of a particular email client."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Gmail",
"description": "The name of the email client."
},
"condition_type": {
"enum": [
"EmailClient"
],
"type": "string",
"x-value": "EmailClient"
}
},
"description": "Segment by use of a particular email client."
},
{
"type": "object",
"title": "Language Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's language is or is not set to a specific language."
},
"field": {
"enum": [
"language"
],
"type": "string",
"title": "Segment Field",
"example": "language",
"description": "Segmenting based off of a subscriber's language."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "en",
"description": "A two-letter language identifier."
},
"condition_type": {
"enum": [
"Language"
],
"type": "string",
"x-value": "Language"
}
},
"description": "Segment by language."
},
{
"type": "object",
"title": "Member Rating Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have have a rating that is/not exactly a given number or members who have a rating greater/less than a given number."
},
"field": {
"enum": [
"rating"
],
"type": "string",
"title": "Segment Field",
"example": "rating",
"description": "Segment by member rating."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 4,
"description": "The star rating number to segment against."
},
"condition_type": {
"enum": [
"MemberRating"
],
"type": "string",
"x-value": "MemberRating"
}
},
"description": "Segment by member rating."
},
{
"type": "object",
"title": "Signup Source Segment",
"required": [
"field",
"condition_type",
"op"
],
"properties": {
"op": {
"enum": [
"source_is",
"source_not"
],
"type": "string",
"title": "Segment Operator",
"example": "source_is",
"description": "Whether the member's signup source was/was not a particular value."
},
"field": {
"enum": [
"source"
],
"type": "string",
"title": "Segment Field",
"example": "source"
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "List Import",
"description": "The signup source."
},
"condition_type": {
"enum": [
"SignupSource"
],
"type": "string",
"title": "Type",
"x-value": "SignupSource"
}
},
"description": "Segment by signup source."
},
{
"type": "object",
"title": "Survey Monkey Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the survey.One of the following: has started the survey, has completed the survey, has not started the survey, or has not completed the survey."
},
"field": {
"enum": [
"survey_monkey"
],
"type": "string",
"title": "Segment Field",
"example": "survey_monkey",
"description": "Segment by interaction with a SurveyMonkey survey."
},
"value": {
"type": "string",
"title": "Survey ID",
"example": "32179586",
"description": "The unique ID of the survey monkey survey."
},
"condition_type": {
"enum": [
"SurveyMonkey"
],
"type": "string",
"x-value": "SurveyMonkey"
}
},
"description": "Segment by interaction with a SurveyMonkey survey."
},
{
"type": "object",
"title": "VIP Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Whether the member is or is not marked as VIP."
},
"field": {
"enum": [
"gmonkey"
],
"type": "string",
"title": "Segment Field",
"example": "gmonkey",
"description": "Segment by VIP status."
},
"condition_type": {
"enum": [
"VIP"
],
"type": "string",
"x-value": "VIP"
}
},
"description": "Segment by VIP status."
},
{
"type": "object",
"title": "Interests Segment",
"properties": {
"op": {
"enum": [
"interestcontains",
"interestcontainsall",
"interestnotcontains"
],
"type": "string",
"title": "Segment Operator",
"example": "interestcontains",
"description": "Whether the member is a part of one, all, or none of the groups."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "interests-123",
"description": "Segmenting based on interest group information. This should start with 'interests-' followed by the grouping id. Ex. 'interests-123'."
},
"value": {
"type": "array",
"items": {
"type": "string",
"example": [
"44401",
"44405",
"44409"
]
},
"title": "Segment Value",
"description": "An array containing strings, each representing a group id."
},
"condition_type": {
"enum": [
"Interests"
],
"type": "string",
"x-value": "Interests"
}
},
"description": "Segment by an interest group merge field."
},
{
"type": "object",
"title": "Ecommerce Category Segment",
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "A member who has purchased from a category/specific item that is/is not a specific name, where the category/item name contains/doesn't contain a specific phrase or string, or a category/item name that starts/ends with a string."
},
"field": {
"enum": [
"ecomm_cat",
"ecomm_prod"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_cat",
"description": "Segment by purchases in specific items or categories."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Product",
"description": "The ecommerce category/item information."
},
"condition_type": {
"enum": [
"EcommCategory"
],
"type": "string",
"x-value": "EcommCategory"
}
},
"description": "Segment by purchases in specific items or categories."
},
{
"type": "object",
"title": "Ecommerce Number Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than the segment value."
},
"field": {
"enum": [
"ecomm_spent_avg",
"ecomm_orders",
"ecomm_prod_all",
"ecomm_avg_ord"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_orders",
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 42,
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than this amount."
},
"condition_type": {
"enum": [
"EcommNumber"
],
"type": "string",
"x-value": "EcommNumber"
}
},
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
{
"type": "object",
"title": "Ecommerce Purchased Segment",
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who have have ('member') or have not ('notmember') purchased."
},
"field": {
"enum": [
"ecomm_purchased"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_purchased",
"description": "Segment by whether someone has purchased anything."
},
"condition_type": {
"enum": [
"EcommPurchased"
],
"type": "string",
"x-value": "EcommPurchased"
}
},
"description": "Segment by whether someone has purchased anything."
},
{
"type": "object",
"title": "Ecommerce Spent Segment",
"properties": {
"op": {
"enum": [
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent 'more' or 'less' than then specified value."
},
"field": {
"enum": [
"ecomm_spent_one",
"ecomm_spent_all"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_spent_one",
"description": "Segment by amount spent on a single order or across all orders."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The total amount a member spent."
},
"condition_type": {
"enum": [
"EcommSpent"
],
"type": "string",
"x-value": "EcommSpent"
}
},
"description": "Segment by amount spent on a single order or across all orders."
},
{
"type": "object",
"title": "Ecommerce Purchased Store Segment",
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who have or have not purchased from a specific store."
},
"field": {
"enum": [
"ecomm_store"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_store",
"description": "Segment by purchases from a specific store."
},
"value": {
"type": "string",
"title": "Segment Operator",
"example": "289",
"description": "The store id to segment against."
},
"condition_type": {
"enum": [
"EcommStore"
],
"type": "string",
"x-value": "EcommStore"
}
},
"description": "Segment by purchases from a specific store."
},
{
"type": "object",
"title": "Goal Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"goal_not",
"contains",
"goal_notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the website URL is/not exactly, contains/doesn't contain, starts with/ends with a string."
},
"field": {
"enum": [
"goal"
],
"type": "string",
"title": "Segment Field",
"example": "goal",
"description": "Segment by Goal activity."
},
"value": {
"type": "string",
"title": "Segment Value",
"description": "The URL to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalActivity"
],
"type": "string",
"x-value": "GoalActivity"
}
},
"description": "Segment by Goal activity."
},
{
"type": "object",
"title": "Goal Timestamp Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Whether the website activity happened after, before, or at a given timestamp."
},
"field": {
"enum": [
"goal_last_visited"
],
"type": "string",
"title": "Segment Field",
"example": "goal_last_visited",
"description": "Segment by most recent interaction with a website."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "2015-07-20 19:45:21",
"description": "The date to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalTimestamp"
],
"type": "string",
"x-value": "GoalTimestamp"
}
},
"description": "Segment by most recent interaction with a website."
},
{
"type": "object",
"title": "Similar Subscribers Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"fuzzy_is",
"fuzzy_not"
],
"type": "string",
"title": "Segment Operator",
"example": "fuzzy_is",
"description": "Members who are/are not apart of a 'similar subscribers' segment."
},
"field": {
"enum": [
"fuzzy_segment"
],
"type": "string",
"title": "Segment Field",
"example": "fuzzy_segment",
"description": "Segment by similar subscribers."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the 'similar subscribers' segment."
},
"condition_type": {
"enum": [
"FuzzySegment"
],
"type": "string",
"x-value": "FuzzySegment"
}
},
"description": "Segment by similar subscribers."
},
{
"type": "object",
"title": "Static Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"static_is",
"static_not"
],
"type": "string",
"title": "Segment Operator",
"example": "static_is",
"description": "Members who are/are not apart of a static segment."
},
"field": {
"enum": [
"static_segment"
],
"type": "string",
"title": "Segment Field",
"example": "static_segment",
"description": "Segment by a given static segment."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the static segment."
},
"condition_type": {
"enum": [
"StaticSegment"
],
"type": "string",
"x-value": "StaticSegment"
}
},
"description": "Segment by a given static segment."
},
{
"type": "object",
"title": "Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeocountry",
"ipgeonotcountry",
"ipgeostate",
"ipgeonotstate"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeocountry",
"description": "Segment members who are within a specific country or US state."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "US",
"description": "The two-letter country code or US state abbreviation."
},
"condition_type": {
"enum": [
"IPGeoCountryState"
],
"type": "string",
"x-value": "IPGeoCountryState"
}
},
"description": "Segment by a specific country or US state."
},
{
"type": "object",
"title": "Geolocation Segment",
"required": [
"field",
"op",
"value",
"addr",
"lat",
"lng"
],
"properties": {
"op": {
"enum": [
"ipgeoin",
"ipgeonotin"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoin",
"description": "Segment members who are within a specific geographic region."
},
"lat": {
"type": "string",
"title": "Segment Location Latitude",
"example": "33.7489954",
"description": "The latitude of the target location."
},
"lng": {
"type": "string",
"title": "Segment Location Longitude",
"example": "-84.3879824",
"description": "The longitude of the target location."
},
"addr": {
"type": "string",
"title": "Segment Location Address",
"example": "Atlanta, GA, USA",
"description": "The address of the target location."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoIn"
],
"type": "string",
"x-value": "IPGeoIn"
}
},
"description": "Segment by a specific geographic region."
},
{
"type": "object",
"title": "US Zip Code Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"ipgeoinzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoinzip",
"description": "Segment members who are within a specific US zip code."
},
"extra": {
"type": "integer",
"title": "Extra Data",
"example": 30318,
"description": "The zip code to segment against."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 25,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoInZip"
],
"type": "string",
"x-value": "IPGeoInZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Unknown Location-Based Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"ipgeounknown"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeounknown",
"description": "Segment members for which location information is unknown."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"condition_type": {
"enum": [
"IPGeoUnknown"
],
"type": "string",
"x-value": "IPGeoUnknown"
}
},
"description": "Segment members whose location information is unknown."
},
{
"type": "object",
"title": "Zip Code Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeoiszip",
"ipgeonotzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeonotzip",
"description": "Segment members who are/are not within a specific US zip code."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 30318,
"description": "The 5-digit zip code."
},
"condition_type": {
"enum": [
"IPGeoZip"
],
"type": "string",
"x-value": "IPGeoZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Social Profiles Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_age"
],
"type": "string",
"title": "Segment Field",
"example": "social_age",
"description": "Segment by age ranges in Social Profiles data."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-54",
"55+"
],
"type": "string",
"title": "Segment Operator",
"example": "35-54",
"description": "The age range to segment."
},
"condition_type": {
"enum": [
"SocialAge"
],
"type": "string",
"x-value": "SocialAge"
}
},
"description": "Segment by age ranges in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_gender"
],
"type": "string",
"title": "Segment Field",
"example": "social_gender",
"description": "Segment by listed gender in Social Profiles data."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The Social Profiles gender to segment."
},
"condition_type": {
"enum": [
"SocialGender"
],
"type": "string",
"x-value": "SocialGender"
}
},
"description": "Segment by listed gender in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Influence Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have a rating that is/not or greater/less than the rating provided."
},
"field": {
"enum": [
"social_influence"
],
"type": "string",
"title": "Segment Field",
"example": "social_influence",
"description": "Segment by influence rating in Social Profiles data."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 2,
"description": "The Social Profiles influence rating to segment."
},
"condition_type": {
"enum": [
"SocialInfluence"
],
"type": "string",
"x-value": "SocialInfluence"
}
},
"description": "Segment by influence rating in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who are/not on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter",
"facebook",
"linkedin",
"flickr",
"foursquare",
"lastfm",
"myspace",
"quora",
"vimeo",
"yelp",
"youtube"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkMember"
],
"type": "string",
"x-value": "SocialNetworkMember"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Follow Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"follow",
"notfollow"
],
"type": "string",
"title": "Segment Operator",
"example": "follow",
"description": "Members who are/not following a linked account on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter_follow"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter_follow",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkFollow"
],
"type": "string",
"x-value": "SocialNetworkFollow"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Address Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"contains",
"notcontain",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's address merge field contains/does not contain a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE3",
"description": "An address-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Atlanta",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"AddressMerge"
],
"type": "string",
"x-value": "AddressMerge"
}
},
"description": "Segment by an address-type merge field."
},
{
"type": "object",
"title": "Address/Zip Merge Field Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"geoin"
],
"type": "string",
"title": "Segment Operator",
"example": "geoin",
"description": "Whether the member's address merge field is within a given distance from a city or zip."
},
"extra": {
"type": "string",
"title": "Segment Extra",
"example": "30318",
"description": "The city or the zip being used to segment against."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE2",
"description": "An address or zip-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "25",
"description": "The distance from the city/zip."
},
"condition_type": {
"enum": [
"ZipMerge"
],
"type": "string",
"x-value": "ZipMerge"
}
},
"description": "Segment by an address-type merge field within a given distance."
},
{
"type": "object",
"title": "Birthday Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's birthday merge information is/is not a certain date or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE4",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30",
"description": "A date to segment against (mm/dd)."
},
"condition_type": {
"enum": [
"BirthdayMerge"
],
"type": "string",
"x-value": "BirthdayMerge"
}
},
"description": "Segment by a contact's birthday."
},
{
"type": "object",
"title": "Date Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"less",
"blank",
"blank_not",
"greater"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not, is greater/less than a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE5",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30/2015",
"description": "A date to segment against."
},
"condition_type": {
"enum": [
"DateMerge"
],
"type": "string",
"x-value": "DateMerge"
}
},
"description": "Segment by a given date merge field."
},
{
"type": "object",
"title": "Dropdown/Radio Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not",
"notcontain",
"contains"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE6",
"description": "A merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Second Choice",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"SelectMerge"
],
"type": "string",
"x-value": "SelectMerge"
}
},
"description": "An individual segment condition"
},
{
"type": "object",
"title": "Text or Number Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's merge information is/is not, contains/does not contain, starts/ends with, or is greater/less than a value"
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE7",
"description": "A text or number merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Freddie's Jokes",
"description": "The value to segment a text or number merge field with."
},
"condition_type": {
"enum": [
"TextMerge"
],
"type": "string",
"x-value": "TextMerge"
}
},
"description": "Segment by a given text or number merge field."
},
{
"type": "object",
"title": "Email Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"description": "Whether the email address is/not exactly, contains/doesn't contain, starts/ends with a string."
},
"field": {
"enum": [
"merge0",
"EMAIL"
],
"type": "string",
"title": "Segment Field",
"example": "EMAIL",
"description": "Segmenting based off of a subscriber's email address."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "urist.mcvankab@freddiesjokes.com",
"description": "The value to compare the email against."
},
"condition_type": {
"enum": [
"EmailAddress"
],
"type": "string",
"x-value": "EmailAddress"
}
},
"description": "Segment by email address."
},
{
"type": "object",
"title": "Predicted Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_gender"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted gender."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted gender to segment."
},
"condition_type": {
"enum": [
"PredictedGender"
],
"type": "string",
"x-value": "PredictedGender"
}
},
"description": "Segment by predicted gender."
},
{
"type": "object",
"title": "Predicted Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_age_range"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted age."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-44",
"45-54",
"55-64",
"65+"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted age to segment."
},
"condition_type": {
"enum": [
"PredictedAge"
],
"type": "string",
"x-value": "PredictedAge"
}
},
"description": "Segment by predicted age."
},
{
"type": "object",
"title": "New Subscribers Prebuilt Segment",
"properties": {
"op": {
"enum": [
"date_within"
],
"type": "string",
"title": "Segment Operator",
"description": "Whe the event took place, namely within a time frame."
},
"field": {
"enum": [
"timestamp_opt"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by when people subscribed."
},
"value": {
"type": "string",
"title": "Segment Data",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"NewSubscribers"
],
"type": "string",
"x-value": "NewSubscribers"
}
},
"description": "Segment by when people subscribed."
}
],
"discriminator": {
"type": "string",
"propertyName": "condition_type"
}
},
"title": "Segment Type",
"description": "Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas)."
}
},
"description": "The [conditions of the segment](https://mailchimp.com/help/save-and-manage-segments/). Static and fuzzy segments don't have conditions."
},
"static_segment": {
"type": "array",
"items": {
"type": "string"
},
"title": "Static Segment",
"description": "An array of emails to be used for a static segment. Any emails provided that are not present on the list will be ignored. Passing an empty array will create a static segment without any subscribers. This field cannot be provided with the options field."
}
},
"description": "Information about a specific list segment."
}
ListsAddNewSegmentResponse
{
"type": "object",
"title": "List",
"properties": {
"id": {
"type": "integer",
"title": "Segment ID",
"readOnly": true,
"description": "The unique id for the segment."
},
"name": {
"type": "string",
"title": "Segment Name",
"description": "The name of the segment."
},
"type": {
"enum": [
"saved",
"static",
"fuzzy"
],
"type": "string",
"title": "Type",
"readOnly": true,
"description": "The type of segment. Static segments are now known as tags. Learn more about [tags](https://mailchimp.com/help/getting-started-tags?utm_source=mc-api&utm_medium=docs&utm_campaign=apidocs)."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"options": {
"type": "object",
"title": "Conditions",
"properties": {
"match": {
"enum": [
"any",
"all"
],
"type": "string",
"title": "Match",
"description": "Match type."
},
"conditions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"title": "Aim Segment",
"properties": {
"op": {
"enum": [
"open",
"click",
"sent",
"noopen",
"noclick",
"nosent"
],
"type": "string",
"title": "Segment Operator",
"example": "open",
"description": "The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn't open, didn't click, or was not sent."
},
"field": {
"enum": [
"aim"
],
"type": "string",
"title": "Segment Field",
"example": "aim",
"description": "Segment by interaction with a specific campaign."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Aim"
],
"type": "string",
"x-value": "Aim"
}
},
"description": "Segment by interaction with a specific campaign."
},
{
"type": "object",
"title": "Automation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow."
},
"field": {
"enum": [
"automation"
],
"type": "string",
"title": "Segment Field",
"example": "automation",
"description": "Segment by interaction with an Automation workflow."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "2135217",
"description": "The web id for the automation workflow to segment against."
},
"condition_type": {
"enum": [
"Automation"
],
"type": "string",
"x-value": "Automation"
}
},
"description": "Segment by interaction with an Automation workflow."
},
{
"type": "object",
"title": "Poll Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members have/have not interacted with a specific poll in a Mailchimp email."
},
"field": {
"enum": [
"poll"
],
"type": "string",
"title": "Segment Field",
"example": "poll",
"description": "Segment by poll activity."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 409,
"description": "The id for the poll."
},
"condition_type": {
"enum": [
"CampaignPoll"
],
"type": "string",
"x-value": "CampaignPoll"
}
},
"description": "Segment by poll activity."
},
{
"type": "object",
"title": "Conversation Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "The status of a member's interaction with a conversation. One of the following: has replied or has not replied."
},
"field": {
"enum": [
"conversation"
],
"type": "string",
"title": "Segment Field",
"example": "conversation",
"description": "Segment by interaction with a campaign via Conversations."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "any",
"description": "The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns."
},
"condition_type": {
"enum": [
"Conversation"
],
"type": "string",
"x-value": "Conversation"
}
},
"description": "Segment by interaction with a campaign via Conversations."
},
{
"type": "object",
"title": "Date Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is",
"not",
"blank",
"blank_not",
"within",
"notwithin"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "When the event took place: Before, after, is a specific date, is not a specific date, is blank, or is not blank."
},
"extra": {
"type": "string",
"title": "Segment Extra Value",
"example": "2015-01-30",
"description": "When segmenting on 'date' or 'campaign', the date for the segment formatted as YYYY-MM-DD or the web id for the campaign."
},
"field": {
"enum": [
"timestamp_opt",
"info_changed",
"ecomm_date"
],
"type": "string",
"title": "Segment Field",
"example": "timestamp_opt",
"description": "The type of date field to segment on: The opt-in time for a signup, the date the subscriber was last updated, or the date of their last ecomm purchase."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "date",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"Date"
],
"type": "string",
"x-value": "Date"
}
},
"description": "Segment by a specific date field."
},
{
"type": "object",
"title": "Email Client Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"client_is",
"client_not"
],
"type": "string",
"title": "Segment Operator",
"example": "client_is",
"description": "The operation to determine whether we select clients that match the value, or clients that do not match the value."
},
"field": {
"enum": [
"email_client"
],
"type": "string",
"title": "Segment Field",
"example": "email_client",
"description": "Segment by use of a particular email client."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Gmail",
"description": "The name of the email client."
},
"condition_type": {
"enum": [
"EmailClient"
],
"type": "string",
"x-value": "EmailClient"
}
},
"description": "Segment by use of a particular email client."
},
{
"type": "object",
"title": "Language Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's language is or is not set to a specific language."
},
"field": {
"enum": [
"language"
],
"type": "string",
"title": "Segment Field",
"example": "language",
"description": "Segmenting based off of a subscriber's language."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "en",
"description": "A two-letter language identifier."
},
"condition_type": {
"enum": [
"Language"
],
"type": "string",
"x-value": "Language"
}
},
"description": "Segment by language."
},
{
"type": "object",
"title": "Member Rating Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have have a rating that is/not exactly a given number or members who have a rating greater/less than a given number."
},
"field": {
"enum": [
"rating"
],
"type": "string",
"title": "Segment Field",
"example": "rating",
"description": "Segment by member rating."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 4,
"description": "The star rating number to segment against."
},
"condition_type": {
"enum": [
"MemberRating"
],
"type": "string",
"x-value": "MemberRating"
}
},
"description": "Segment by member rating."
},
{
"type": "object",
"title": "Signup Source Segment",
"required": [
"field",
"condition_type",
"op"
],
"properties": {
"op": {
"enum": [
"source_is",
"source_not"
],
"type": "string",
"title": "Segment Operator",
"example": "source_is",
"description": "Whether the member's signup source was/was not a particular value."
},
"field": {
"enum": [
"source"
],
"type": "string",
"title": "Segment Field",
"example": "source"
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "List Import",
"description": "The signup source."
},
"condition_type": {
"enum": [
"SignupSource"
],
"type": "string",
"title": "Type",
"x-value": "SignupSource"
}
},
"description": "Segment by signup source."
},
{
"type": "object",
"title": "Survey Monkey Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"started",
"completed",
"not_started",
"not_completed"
],
"type": "string",
"title": "Segment Operator",
"example": "started",
"description": "The status of the member with regard to the survey.One of the following: has started the survey, has completed the survey, has not started the survey, or has not completed the survey."
},
"field": {
"enum": [
"survey_monkey"
],
"type": "string",
"title": "Segment Field",
"example": "survey_monkey",
"description": "Segment by interaction with a SurveyMonkey survey."
},
"value": {
"type": "string",
"title": "Survey ID",
"example": "32179586",
"description": "The unique ID of the survey monkey survey."
},
"condition_type": {
"enum": [
"SurveyMonkey"
],
"type": "string",
"x-value": "SurveyMonkey"
}
},
"description": "Segment by interaction with a SurveyMonkey survey."
},
{
"type": "object",
"title": "VIP Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Whether the member is or is not marked as VIP."
},
"field": {
"enum": [
"gmonkey"
],
"type": "string",
"title": "Segment Field",
"example": "gmonkey",
"description": "Segment by VIP status."
},
"condition_type": {
"enum": [
"VIP"
],
"type": "string",
"x-value": "VIP"
}
},
"description": "Segment by VIP status."
},
{
"type": "object",
"title": "Interests Segment",
"properties": {
"op": {
"enum": [
"interestcontains",
"interestcontainsall",
"interestnotcontains"
],
"type": "string",
"title": "Segment Operator",
"example": "interestcontains",
"description": "Whether the member is a part of one, all, or none of the groups."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "interests-123",
"description": "Segmenting based on interest group information. This should start with 'interests-' followed by the grouping id. Ex. 'interests-123'."
},
"value": {
"type": "array",
"items": {
"type": "string",
"example": [
"44401",
"44405",
"44409"
]
},
"title": "Segment Value",
"description": "An array containing strings, each representing a group id."
},
"condition_type": {
"enum": [
"Interests"
],
"type": "string",
"x-value": "Interests"
}
},
"description": "Segment by an interest group merge field."
},
{
"type": "object",
"title": "Ecommerce Category Segment",
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "A member who has purchased from a category/specific item that is/is not a specific name, where the category/item name contains/doesn't contain a specific phrase or string, or a category/item name that starts/ends with a string."
},
"field": {
"enum": [
"ecomm_cat",
"ecomm_prod"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_cat",
"description": "Segment by purchases in specific items or categories."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "Product",
"description": "The ecommerce category/item information."
},
"condition_type": {
"enum": [
"EcommCategory"
],
"type": "string",
"x-value": "EcommCategory"
}
},
"description": "Segment by purchases in specific items or categories."
},
{
"type": "object",
"title": "Ecommerce Number Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than the segment value."
},
"field": {
"enum": [
"ecomm_spent_avg",
"ecomm_orders",
"ecomm_prod_all",
"ecomm_avg_ord"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_orders",
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 42,
"description": "Members who have spent exactly, have not spent exactly, spent more, or spent less than this amount."
},
"condition_type": {
"enum": [
"EcommNumber"
],
"type": "string",
"x-value": "EcommNumber"
}
},
"description": "Segment by average spent total, number of orders, total number of products purchased, or average number of products per order."
},
{
"type": "object",
"title": "Ecommerce Purchased Segment",
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who have have ('member') or have not ('notmember') purchased."
},
"field": {
"enum": [
"ecomm_purchased"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_purchased",
"description": "Segment by whether someone has purchased anything."
},
"condition_type": {
"enum": [
"EcommPurchased"
],
"type": "string",
"x-value": "EcommPurchased"
}
},
"description": "Segment by whether someone has purchased anything."
},
{
"type": "object",
"title": "Ecommerce Spent Segment",
"properties": {
"op": {
"enum": [
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have spent 'more' or 'less' than then specified value."
},
"field": {
"enum": [
"ecomm_spent_one",
"ecomm_spent_all"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_spent_one",
"description": "Segment by amount spent on a single order or across all orders."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The total amount a member spent."
},
"condition_type": {
"enum": [
"EcommSpent"
],
"type": "string",
"x-value": "EcommSpent"
}
},
"description": "Segment by amount spent on a single order or across all orders."
},
{
"type": "object",
"title": "Ecommerce Purchased Store Segment",
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who have or have not purchased from a specific store."
},
"field": {
"enum": [
"ecomm_store"
],
"type": "string",
"title": "Segment Field",
"example": "ecomm_store",
"description": "Segment by purchases from a specific store."
},
"value": {
"type": "string",
"title": "Segment Operator",
"example": "289",
"description": "The store id to segment against."
},
"condition_type": {
"enum": [
"EcommStore"
],
"type": "string",
"x-value": "EcommStore"
}
},
"description": "Segment by purchases from a specific store."
},
{
"type": "object",
"title": "Goal Activity Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"goal_not",
"contains",
"goal_notcontain",
"starts",
"ends"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the website URL is/not exactly, contains/doesn't contain, starts with/ends with a string."
},
"field": {
"enum": [
"goal"
],
"type": "string",
"title": "Segment Field",
"example": "goal",
"description": "Segment by Goal activity."
},
"value": {
"type": "string",
"title": "Segment Value",
"description": "The URL to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalActivity"
],
"type": "string",
"x-value": "GoalActivity"
}
},
"description": "Segment by Goal activity."
},
{
"type": "object",
"title": "Goal Timestamp Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"greater",
"less",
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Whether the website activity happened after, before, or at a given timestamp."
},
"field": {
"enum": [
"goal_last_visited"
],
"type": "string",
"title": "Segment Field",
"example": "goal_last_visited",
"description": "Segment by most recent interaction with a website."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "2015-07-20 19:45:21",
"description": "The date to check Goal activity against."
},
"condition_type": {
"enum": [
"GoalTimestamp"
],
"type": "string",
"x-value": "GoalTimestamp"
}
},
"description": "Segment by most recent interaction with a website."
},
{
"type": "object",
"title": "Similar Subscribers Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"fuzzy_is",
"fuzzy_not"
],
"type": "string",
"title": "Segment Operator",
"example": "fuzzy_is",
"description": "Members who are/are not apart of a 'similar subscribers' segment."
},
"field": {
"enum": [
"fuzzy_segment"
],
"type": "string",
"title": "Segment Field",
"example": "fuzzy_segment",
"description": "Segment by similar subscribers."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the 'similar subscribers' segment."
},
"condition_type": {
"enum": [
"FuzzySegment"
],
"type": "string",
"x-value": "FuzzySegment"
}
},
"description": "Segment by similar subscribers."
},
{
"type": "object",
"title": "Static Segment Member Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"static_is",
"static_not"
],
"type": "string",
"title": "Segment Operator",
"example": "static_is",
"description": "Members who are/are not apart of a static segment."
},
"field": {
"enum": [
"static_segment"
],
"type": "string",
"title": "Segment Field",
"example": "static_segment",
"description": "Segment by a given static segment."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 48433,
"description": "The id for the static segment."
},
"condition_type": {
"enum": [
"StaticSegment"
],
"type": "string",
"x-value": "StaticSegment"
}
},
"description": "Segment by a given static segment."
},
{
"type": "object",
"title": "Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeocountry",
"ipgeonotcountry",
"ipgeostate",
"ipgeonotstate"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeocountry",
"description": "Segment members who are within a specific country or US state."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "string",
"title": "Segment Data",
"example": "US",
"description": "The two-letter country code or US state abbreviation."
},
"condition_type": {
"enum": [
"IPGeoCountryState"
],
"type": "string",
"x-value": "IPGeoCountryState"
}
},
"description": "Segment by a specific country or US state."
},
{
"type": "object",
"title": "Geolocation Segment",
"required": [
"field",
"op",
"value",
"addr",
"lat",
"lng"
],
"properties": {
"op": {
"enum": [
"ipgeoin",
"ipgeonotin"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoin",
"description": "Segment members who are within a specific geographic region."
},
"lat": {
"type": "string",
"title": "Segment Location Latitude",
"example": "33.7489954",
"description": "The latitude of the target location."
},
"lng": {
"type": "string",
"title": "Segment Location Longitude",
"example": "-84.3879824",
"description": "The longitude of the target location."
},
"addr": {
"type": "string",
"title": "Segment Location Address",
"example": "Atlanta, GA, USA",
"description": "The address of the target location."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 42,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoIn"
],
"type": "string",
"x-value": "IPGeoIn"
}
},
"description": "Segment by a specific geographic region."
},
{
"type": "object",
"title": "US Zip Code Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"ipgeoinzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeoinzip",
"description": "Segment members who are within a specific US zip code."
},
"extra": {
"type": "integer",
"title": "Extra Data",
"example": 30318,
"description": "The zip code to segment against."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 25,
"description": "The radius of the target location."
},
"condition_type": {
"enum": [
"IPGeoInZip"
],
"type": "string",
"x-value": "IPGeoInZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Unknown Location-Based Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"ipgeounknown"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeounknown",
"description": "Segment members for which location information is unknown."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"condition_type": {
"enum": [
"IPGeoUnknown"
],
"type": "string",
"x-value": "IPGeoUnknown"
}
},
"description": "Segment members whose location information is unknown."
},
{
"type": "object",
"title": "Zip Code Location-Based Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"ipgeoiszip",
"ipgeonotzip"
],
"type": "string",
"title": "Segment Operator",
"example": "ipgeonotzip",
"description": "Segment members who are/are not within a specific US zip code."
},
"field": {
"enum": [
"ipgeo"
],
"type": "string",
"title": "Segment Field",
"example": "ipgeo",
"description": "Segmenting subscribers who are within a specific location."
},
"value": {
"type": "integer",
"title": "Segment Data",
"example": 30318,
"description": "The 5-digit zip code."
},
"condition_type": {
"enum": [
"IPGeoZip"
],
"type": "string",
"x-value": "IPGeoZip"
}
},
"description": "Segment by a specific US ZIP code."
},
{
"type": "object",
"title": "Social Profiles Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_age"
],
"type": "string",
"title": "Segment Field",
"example": "social_age",
"description": "Segment by age ranges in Social Profiles data."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-54",
"55+"
],
"type": "string",
"title": "Segment Operator",
"example": "35-54",
"description": "The age range to segment."
},
"condition_type": {
"enum": [
"SocialAge"
],
"type": "string",
"x-value": "SocialAge"
}
},
"description": "Segment by age ranges in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"social_gender"
],
"type": "string",
"title": "Segment Field",
"example": "social_gender",
"description": "Segment by listed gender in Social Profiles data."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The Social Profiles gender to segment."
},
"condition_type": {
"enum": [
"SocialGender"
],
"type": "string",
"x-value": "SocialGender"
}
},
"description": "Segment by listed gender in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Influence Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"example": "greater",
"description": "Members who have a rating that is/not or greater/less than the rating provided."
},
"field": {
"enum": [
"social_influence"
],
"type": "string",
"title": "Segment Field",
"example": "social_influence",
"description": "Segment by influence rating in Social Profiles data."
},
"value": {
"type": "number",
"title": "Segment Operator",
"example": 2,
"description": "The Social Profiles influence rating to segment."
},
"condition_type": {
"enum": [
"SocialInfluence"
],
"type": "string",
"x-value": "SocialInfluence"
}
},
"description": "Segment by influence rating in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"member",
"notmember"
],
"type": "string",
"title": "Segment Operator",
"example": "member",
"description": "Members who are/not on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter",
"facebook",
"linkedin",
"flickr",
"foursquare",
"lastfm",
"myspace",
"quora",
"vimeo",
"yelp",
"youtube"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkMember"
],
"type": "string",
"x-value": "SocialNetworkMember"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Social Profiles Social Network Follow Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"follow",
"notfollow"
],
"type": "string",
"title": "Segment Operator",
"example": "follow",
"description": "Members who are/not following a linked account on a given social network."
},
"field": {
"enum": [
"social_network"
],
"type": "string",
"title": "Segment Field",
"example": "social_network",
"description": "Segment by social network in Social Profiles data."
},
"value": {
"enum": [
"twitter_follow"
],
"type": "string",
"title": "Segment Operator",
"example": "twitter_follow",
"description": "The social network to segment against."
},
"condition_type": {
"enum": [
"SocialNetworkFollow"
],
"type": "string",
"x-value": "SocialNetworkFollow"
}
},
"description": "Segment by social network in Social Profiles data."
},
{
"type": "object",
"title": "Address Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"contains",
"notcontain",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's address merge field contains/does not contain a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE3",
"description": "An address-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Atlanta",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"AddressMerge"
],
"type": "string",
"x-value": "AddressMerge"
}
},
"description": "Segment by an address-type merge field."
},
{
"type": "object",
"title": "Address/Zip Merge Field Segment",
"required": [
"field",
"op",
"value",
"extra"
],
"properties": {
"op": {
"enum": [
"geoin"
],
"type": "string",
"title": "Segment Operator",
"example": "geoin",
"description": "Whether the member's address merge field is within a given distance from a city or zip."
},
"extra": {
"type": "string",
"title": "Segment Extra",
"example": "30318",
"description": "The city or the zip being used to segment against."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE2",
"description": "An address or zip-type merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "25",
"description": "The distance from the city/zip."
},
"condition_type": {
"enum": [
"ZipMerge"
],
"type": "string",
"x-value": "ZipMerge"
}
},
"description": "Segment by an address-type merge field within a given distance."
},
{
"type": "object",
"title": "Birthday Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's birthday merge information is/is not a certain date or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE4",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30",
"description": "A date to segment against (mm/dd)."
},
"condition_type": {
"enum": [
"BirthdayMerge"
],
"type": "string",
"x-value": "BirthdayMerge"
}
},
"description": "Segment by a contact's birthday."
},
{
"type": "object",
"title": "Date Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"less",
"blank",
"blank_not",
"greater"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not, is greater/less than a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE5",
"description": "A date merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "01/30/2015",
"description": "A date to segment against."
},
"condition_type": {
"enum": [
"DateMerge"
],
"type": "string",
"x-value": "DateMerge"
}
},
"description": "Segment by a given date merge field."
},
{
"type": "object",
"title": "Dropdown/Radio Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"blank",
"blank_not",
"notcontain",
"contains"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Whether the member's merge information is/is not a value or is/is not blank."
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE6",
"description": "A merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Second Choice",
"description": "The value to segment a text merge field with."
},
"condition_type": {
"enum": [
"SelectMerge"
],
"type": "string",
"x-value": "SelectMerge"
}
},
"description": "An individual segment condition"
},
{
"type": "object",
"title": "Text or Number Merge Field Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less",
"blank",
"blank_not"
],
"type": "string",
"title": "Segment Operator",
"example": "contains",
"description": "Whether the member's merge information is/is not, contains/does not contain, starts/ends with, or is greater/less than a value"
},
"field": {
"type": "string",
"title": "Segment Field",
"example": "MMERGE7",
"description": "A text or number merge field to segment."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "Freddie's Jokes",
"description": "The value to segment a text or number merge field with."
},
"condition_type": {
"enum": [
"TextMerge"
],
"type": "string",
"x-value": "TextMerge"
}
},
"description": "Segment by a given text or number merge field."
},
{
"type": "object",
"title": "Email Segment",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"is",
"not",
"contains",
"notcontain",
"starts",
"ends",
"greater",
"less"
],
"type": "string",
"title": "Segment Operator",
"description": "Whether the email address is/not exactly, contains/doesn't contain, starts/ends with a string."
},
"field": {
"enum": [
"merge0",
"EMAIL"
],
"type": "string",
"title": "Segment Field",
"example": "EMAIL",
"description": "Segmenting based off of a subscriber's email address."
},
"value": {
"type": "string",
"title": "Segment Value",
"example": "urist.mcvankab@freddiesjokes.com",
"description": "The value to compare the email against."
},
"condition_type": {
"enum": [
"EmailAddress"
],
"type": "string",
"x-value": "EmailAddress"
}
},
"description": "Segment by email address."
},
{
"type": "object",
"title": "Predicted Gender Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is",
"not"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_gender"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted gender."
},
"value": {
"enum": [
"male",
"female"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted gender to segment."
},
"condition_type": {
"enum": [
"PredictedGender"
],
"type": "string",
"x-value": "PredictedGender"
}
},
"description": "Segment by predicted gender."
},
{
"type": "object",
"title": "Predicted Age Segment",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"is"
],
"type": "string",
"title": "Segment Operator",
"example": "is",
"description": "Members who are/not the exact criteria listed."
},
"field": {
"enum": [
"predicted_age_range"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by predicted age."
},
"value": {
"enum": [
"18-24",
"25-34",
"35-44",
"45-54",
"55-64",
"65+"
],
"type": "string",
"title": "Segment Operator",
"example": "female",
"description": "The predicted age to segment."
},
"condition_type": {
"enum": [
"PredictedAge"
],
"type": "string",
"x-value": "PredictedAge"
}
},
"description": "Segment by predicted age."
},
{
"type": "object",
"title": "New Subscribers Prebuilt Segment",
"properties": {
"op": {
"enum": [
"date_within"
],
"type": "string",
"title": "Segment Operator",
"description": "Whe the event took place, namely within a time frame."
},
"field": {
"enum": [
"timestamp_opt"
],
"type": "string",
"title": "Segment Field",
"description": "Segment by when people subscribed."
},
"value": {
"type": "string",
"title": "Segment Data",
"description": "What type of data to segment on: a specific date, a specific campaign, or the last campaign sent."
},
"condition_type": {
"enum": [
"NewSubscribers"
],
"type": "string",
"x-value": "NewSubscribers"
}
},
"description": "Segment by when people subscribed."
}
],
"discriminator": {
"type": "string",
"propertyName": "condition_type"
}
},
"title": "Segment Type",
"description": "Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas)."
}
},
"description": "The conditions of the segment. Static segments (tags) and fuzzy segments don't have conditions."
},
"created_at": {
"type": "string",
"title": "Date Created",
"format": "date-time",
"readOnly": true,
"description": "The date and time the segment was created in ISO 8601 format."
},
"updated_at": {
"type": "string",
"title": "Date Updated",
"format": "date-time",
"readOnly": true,
"description": "The date and time the segment was last updated in ISO 8601 format."
},
"member_count": {
"type": "integer",
"title": "Member Count",
"readOnly": true,
"description": "The number of active subscribers currently included in the segment."
}
},
"description": "Information about a specific segment."
}
ListsAddNewSegmentdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsAddOrUpdateMember200Response
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "Returns up to 50 tags applied to this member. To retrieve all tags see [Member Tags](https://mailchimp.com/developer/marketing/api/list-member-tags/)."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
},
"ecommerce_data": {
"type": "object",
"title": "Ecommerce Stats",
"readOnly": true,
"properties": {
"currency_code": {
"type": "string",
"title": "Currency",
"example": "USD",
"readOnly": true,
"description": "The three-letter ISO 4217 code for the currency that the store accepts."
},
"total_revenue": {
"type": "number",
"title": "Total Revenue",
"readOnly": true,
"description": "The total revenue the list member has brought in."
},
"number_of_orders": {
"type": "number",
"title": "Total Number of Orders",
"readOnly": true,
"description": "The total number of orders placed by the list member."
}
},
"description": "Ecommerce stats for the list member if the list is attached to a store."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"source": {
"type": "string",
"title": "Subscriber Source",
"readOnly": true,
"description": "The source from which the subscriber was added to this list."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional",
"archived"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"web_id": {
"type": "integer",
"title": "Member Web ID",
"readOnly": true,
"description": "The ID used in the Mailchimp web application. View this member in your Mailchimp account at `https://{dc}.admin.mailchimp.com/lists/members/view?id={web_id}`."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"region": {
"type": "string",
"title": "Region",
"readOnly": true,
"description": "The region for the location."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"full_name": {
"type": "string",
"title": "Full Name",
"readOnly": true,
"description": "The contact's full name."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"sms_phone_number": {
"type": "string",
"title": "SMS Phone Number",
"description": "A US phone number for SMS contact."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"unsubscribe_reason": {
"type": "string",
"title": "Unsubscribe Reason",
"description": "A subscriber's reason for unsubscribing."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"text": {
"type": "string",
"title": "Marketing Permission Text",
"description": "The text of the marketing permission."
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
},
"sms_subscription_status": {
"enum": [
"subscribed",
"unsubscribed",
"nonsubscribed",
"pending"
],
"type": "string",
"title": "SMS Subscription Status",
"description": "The status of an SMS subscription."
},
"sms_subscription_last_updated": {
"type": "string",
"title": "SMS Subscription Last Update",
"description": "The datetime when the SMS subscription was last updated"
},
"consents_to_one_to_one_messaging": {
"type": "boolean",
"title": "Messaging Consent",
"readOnly": true,
"description": "Indicates whether a contact consents to 1:1 messaging."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddOrUpdateMemberRequest
{
"type": "object",
"title": "Add List Members",
"required": [
"email_address",
"status_if_new"
],
"properties": {
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"description": "IP address the subscriber signed up from."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber. This value is required only if the email address is not already present on the list."
},
"status_if_new": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "New Member Status",
"description": "Subscriber's status. This value is required only if the email address is not already present on the list."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddOrUpdateMemberResponse
{
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "Returns up to 50 tags applied to this member. To retrieve all tags see [Member Tags](https://mailchimp.com/developer/marketing/api/list-member-tags/)."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
},
"ecommerce_data": {
"type": "object",
"title": "Ecommerce Stats",
"readOnly": true,
"properties": {
"currency_code": {
"type": "string",
"title": "Currency",
"example": "USD",
"readOnly": true,
"description": "The three-letter ISO 4217 code for the currency that the store accepts."
},
"total_revenue": {
"type": "number",
"title": "Total Revenue",
"readOnly": true,
"description": "The total revenue the list member has brought in."
},
"number_of_orders": {
"type": "number",
"title": "Total Number of Orders",
"readOnly": true,
"description": "The total number of orders placed by the list member."
}
},
"description": "Ecommerce stats for the list member if the list is attached to a store."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"source": {
"type": "string",
"title": "Subscriber Source",
"readOnly": true,
"description": "The source from which the subscriber was added to this list."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional",
"archived"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"web_id": {
"type": "integer",
"title": "Member Web ID",
"readOnly": true,
"description": "The ID used in the Mailchimp web application. View this member in your Mailchimp account at `https://{dc}.admin.mailchimp.com/lists/members/view?id={web_id}`."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"region": {
"type": "string",
"title": "Region",
"readOnly": true,
"description": "The region for the location."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"full_name": {
"type": "string",
"title": "Full Name",
"readOnly": true,
"description": "The contact's full name."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"contact_id": {
"type": "string",
"title": "Contact ID",
"readOnly": true,
"description": "As Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the `id` is the MD5 hash of their email address, this `contact_id` is agnostic of contact’s inclusion of an email address."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Merge Fields",
"description": "A dictionary of merge fields where the keys are the merge tags. See the [Merge Fields documentation](https://mailchimp.com/developer/marketing/docs/merge-fields/#structure) for more about the structure.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"sms_phone_number": {
"type": "string",
"title": "SMS Phone Number",
"description": "A US phone number for SMS contact."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
},
"unsubscribe_reason": {
"type": "string",
"title": "Unsubscribe Reason",
"description": "A subscriber's reason for unsubscribing."
},
"marketing_permissions": {
"type": "array",
"items": {
"type": "object",
"title": "Marketing Permission",
"properties": {
"text": {
"type": "string",
"title": "Marketing Permission Text",
"description": "The text of the marketing permission."
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "If the subscriber has opted-in to the marketing permission."
},
"marketing_permission_id": {
"type": "string",
"title": "Marketing Permission ID",
"description": "The id for the marketing permission on the list"
}
},
"description": "A single marketing permission a subscriber has either opted-in to or opted-out of."
},
"title": "Marketing Permissions",
"description": "The marketing permissions for the subscriber."
},
"sms_subscription_status": {
"enum": [
"subscribed",
"unsubscribed",
"nonsubscribed",
"pending"
],
"type": "string",
"title": "SMS Subscription Status",
"description": "The status of an SMS subscription."
},
"sms_subscription_last_updated": {
"type": "string",
"title": "SMS Subscription Last Update",
"description": "The datetime when the SMS subscription was last updated"
},
"consents_to_one_to_one_messaging": {
"type": "boolean",
"title": "Messaging Consent",
"readOnly": true,
"description": "Indicates whether a contact consents to 1:1 messaging."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
}
ListsAddOrUpdateMemberdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsArchiveMemberResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsArchiveMemberdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsBatchAddRemoveMembers200Response
{
"type": "object",
"title": "Batch add/remove List members to/from static segment",
"properties": {
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"error": {
"type": "string",
"title": "Error message",
"description": "The error message indicating why the email addresses could not be added or updated."
},
"email_addresses": {
"type": "array",
"items": {
"type": "string"
},
"title": "Email addresses added to the static segment or removed",
"description": "Email addresses added to the static segment or removed"
}
}
},
"title": "Errors",
"description": "An array of objects, each representing an array of email addresses that could not be added to the segment or removed and an error message providing more details."
},
"error_count": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"total_added": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"members_added": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "Members Added",
"description": "An array of objects, each representing a new member that was added to the static segment."
},
"total_removed": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"members_removed": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "Members Removed",
"description": "An array of objects, each representing an existing list member that got deleted from the static segment."
}
},
"description": "Batch add/remove List members to/from static segment"
}
ListsBatchAddRemoveMembersRequest
{
"type": "object",
"title": "Members to add/remove to/from a static segment",
"properties": {
"members_to_add": {
"type": "array",
"items": {
"type": "string"
},
"title": "Members to add to the static segment",
"description": "An array of emails to be used for a static segment. Any emails provided that are not present on the list will be ignored. A maximum of 500 members can be sent."
},
"members_to_remove": {
"type": "array",
"items": {
"type": "string"
},
"title": "Members to remove from the static segment",
"description": "An array of emails to be used for a static segment. Any emails provided that are not present on the list will be ignored. A maximum of 500 members can be sent."
}
},
"description": "Members to add/remove to/from a static segment"
}
ListsBatchAddRemoveMembersResponse
{
"type": "object",
"title": "Batch add/remove List members to/from static segment",
"properties": {
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"error": {
"type": "string",
"title": "Error message",
"description": "The error message indicating why the email addresses could not be added or updated."
},
"email_addresses": {
"type": "array",
"items": {
"type": "string"
},
"title": "Email addresses added to the static segment or removed",
"description": "Email addresses added to the static segment or removed"
}
}
},
"title": "Errors",
"description": "An array of objects, each representing an array of email addresses that could not be added to the segment or removed and an error message providing more details."
},
"error_count": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"total_added": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"members_added": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "Members Added",
"description": "An array of objects, each representing a new member that was added to the static segment."
},
"total_removed": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"members_removed": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "Members Removed",
"description": "An array of objects, each representing an existing list member that got deleted from the static segment."
}
},
"description": "Batch add/remove List members to/from static segment"
}
ListsBatchAddRemoveMembersdefaultResponse
{
"type": "object",
"title": "Problem Detail Document",
"required": [
"type",
"title",
"status",
"detail",
"instance"
],
"properties": {
"type": {
"type": "string",
"title": "Problem Type",
"example": "https://mailchimp.com/developer/marketing/docs/errors/",
"description": "An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type."
},
"title": {
"type": "string",
"title": "Error Title",
"example": "Resource Not Found",
"description": "A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization."
},
"detail": {
"type": "string",
"title": "Error Message",
"example": "The requested resource could not be found.",
"description": "A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](https://mailchimp.com/developer/)."
},
"status": {
"type": "integer",
"title": "HTTP Status Code",
"example": 404,
"description": "The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem."
},
"instance": {
"type": "string",
"title": "Instance ID",
"example": "995c5cb0-3280-4a6e-808b-3b096d0bb219",
"description": "A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support."
}
},
"description": "An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'."
}
ListsBatchSubscribeOrUnsubscribe200Response
{
"type": "object",
"title": "Batch update List members",
"properties": {
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"error": {
"type": "string",
"title": "Error message",
"description": "The error message indicating why the email address could not be added or updated."
},
"field": {
"type": "string",
"title": "Field",
"description": "If the error is field-related, information about which field is at issue."
},
"error_code": {
"enum": [
"ERROR_CONTACT_EXISTS",
"ERROR_GENERIC"
],
"type": "string",
"title": "Error code",
"description": "A unique code that identifies this specifc error."
},
"email_address": {
"type": "string",
"title": "Member Email address",
"description": "The email address that could not be added or updated."
},
"field_message": {
"type": "string",
"title": "Field message",
"description": "Message indicating how to resolve a field-related error."
}
}
},
"title": "Errors",
"description": "An array of objects, each representing an email address that could not be added to the list or updated and an error message providing more details."
},
"error_count": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"new_members": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "New members",
"description": "An array of objects, each representing a new member that was added to the list."
},
"total_created": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"total_updated": {
"type": "integer",
"title": "Item Count",
"example": 42,
"description": "The total number of items matching the query, irrespective of pagination."
},
"updated_members": {
"type": "array",
"items": {
"type": "object",
"title": "List Members",
"properties": {
"id": {
"type": "string",
"title": "Email ID",
"readOnly": true,
"description": "The MD5 hash of the lowercase version of the list member's email address."
},
"vip": {
"type": "boolean",
"title": "VIP",
"description": "[VIP status](https://mailchimp.com/help/designate-and-send-to-vip-contacts/) for subscriber."
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"title": "Tag ID",
"readOnly": true,
"description": "The tag id."
},
"name": {
"type": "string",
"title": "Tag Name",
"readOnly": true,
"description": "The name of the tag"
}
}
},
"title": "Tags",
"readOnly": false,
"description": "The tags applied to this member."
},
"stats": {
"type": "object",
"title": "Subscriber Stats",
"readOnly": true,
"properties": {
"avg_open_rate": {
"type": "number",
"title": "Average Open Rate",
"readOnly": true,
"description": "A subscriber's average open rate."
},
"avg_click_rate": {
"type": "number",
"title": "Average Click Rate",
"readOnly": true,
"description": "A subscriber's average clickthrough rate."
}
},
"description": "Open and click rates for this subscriber."
},
"_links": {
"type": "array",
"items": {
"type": "object",
"title": "Resource Link",
"properties": {
"rel": {
"type": "string",
"title": "Rel",
"readOnly": true,
"description": "As with an HTML 'rel' attribute, this describes the type of link."
},
"href": {
"type": "string",
"title": "Href",
"readOnly": true,
"description": "This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"OPTIONS",
"HEAD"
],
"type": "string",
"title": "Method",
"readOnly": true,
"description": "The HTTP method that should be used when accessing the URL defined in 'href'."
},
"schema": {
"type": "string",
"title": "Schema",
"readOnly": true,
"description": "For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to."
},
"targetSchema": {
"type": "string",
"title": "Target Schema",
"readOnly": true,
"description": "For GETs, this is a URL representing the schema that the response should conform to."
}
},
"description": "This object represents a link from the resource where it is found to another resource or action that may be performed."
},
"title": "Links",
"readOnly": true,
"description": "A list of link types and descriptions for the API schema documents."
},
"ip_opt": {
"type": "string",
"title": "Opt-in IP",
"readOnly": true,
"description": "The IP address the subscriber used to confirm their opt-in status."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"type": "string",
"title": "Status",
"description": "Subscriber's current status."
},
"list_id": {
"type": "string",
"title": "List ID",
"readOnly": true,
"description": "The list id."
},
"language": {
"type": "string",
"title": "Language",
"description": "If set/detected, the [subscriber's language](https://mailchimp.com/help/view-and-edit-contact-languages/)."
},
"location": {
"type": "object",
"title": "Location",
"properties": {
"dstoff": {
"type": "integer",
"title": "DST Offset",
"readOnly": true,
"description": "The offset for timezones where daylight saving time is observed."
},
"gmtoff": {
"type": "integer",
"title": "GMT Offset",
"readOnly": true,
"description": "The time difference in hours from GMT."
},
"latitude": {
"type": "number",
"title": "Latitude",
"description": "The location latitude."
},
"timezone": {
"type": "string",
"title": "Timezone",
"readOnly": true,
"description": "The timezone for the location."
},
"longitude": {
"type": "number",
"title": "Longitude",
"description": "The location longitude."
},
"country_code": {
"type": "string",
"title": "Country Code",
"readOnly": true,
"description": "The unique code for the location country."
}
},
"description": "Subscriber location information."
},
"interests": {
"type": "object",
"title": "Subscriber Interests",
"description": "The key of this object's properties is the ID of the interest in question.",
"additionalProperties": {
"type": "boolean",
"title": "Interest Value",
"description": "Keys are interest IDs, values are booleans that describe whether the list member is in that group or not."
}
},
"ip_signup": {
"type": "string",
"title": "Signup IP",
"readOnly": true,
"description": "IP address the subscriber signed up from."
},
"last_note": {
"type": "object",
"title": "Notes",
"readOnly": true,
"properties": {
"note": {
"type": "string",
"title": "Note",
"readOnly": true,
"description": "The content of the note."
},
"note_id": {
"type": "integer",
"title": "Note ID",
"readOnly": true,
"description": "The note id."
},
"created_at": {
"type": "string",
"title": "Created Time",
"format": "date-time",
"readOnly": true,
"description": "The date and time the note was created in ISO 8601 format."
},
"created_by": {
"type": "string",
"title": "Author",
"readOnly": true,
"description": "The author of the note."
}
},
"description": "The most recent Note added about this member."
},
"email_type": {
"type": "string",
"title": "Email Type",
"description": "Type of email this member asked to get ('html' or 'text')."
},
"tags_count": {
"type": "integer",
"title": "Tags Count",
"readOnly": true,
"description": "The number of tags applied to this member."
},
"email_client": {
"type": "string",
"title": "Email Client",
"readOnly": true,
"description": "The list member's email client."
},
"last_changed": {
"type": "string",
"title": "Last Changed Date",
"format": "date-time",
"readOnly": true,
"description": "The date and time the member's info was last changed in ISO 8601 format."
},
"merge_fields": {
"type": "object",
"title": "Member Merge Var",
"description": "An individual merge var and value for a member.",
"additionalProperties": {
"description": "This object's keys are merge tags (like FNAME). It's values are the values to be added to the merge field."
}
},
"email_address": {
"type": "string",
"title": "Email Address",
"description": "Email address for a subscriber."
},
"member_rating": {
"type": "integer",
"title": "Member Rating",
"readOnly": true,
"description": "Star rating for this member, between 1 and 5."
},
"timestamp_opt": {
"type": "string",
"title": "Opt-in Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber confirmed their opt-in status in ISO 8601 format."
},
"unique_email_id": {
"type": "string",
"title": "Unique Email ID",
"readOnly": true,
"description": "An identifier for the address across all of Mailchimp."
},
"timestamp_signup": {
"type": "string",
"title": "Signup Timestamp",
"format": "date-time",
"readOnly": true,
"description": "The date and time the subscriber signed up for the list in ISO 8601 format."
}
},
"description": "Individuals who are currently or have been previously subscribed to this list, including members who have bounced or unsubscribed."
},
"title": "Updated Members",
"description": "An array of objects, each representing an existing list member whose subscription status was updated."
}
},
"description": "Batch update list members."
}