Mailchimp Landing Pages API
The landingPages API from Mailchimp — 5 operation(s) for landingpages.
The landingPages API from Mailchimp — 5 operation(s) for landingpages.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mailchimp-landingpages-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
version: 3.0.91
title: Mailchimp Marketing Landing Pages API
contact:
name: Mailchimp API Support
email: apihelp@mailchimp.com
x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/marketing.json
servers:
- url: https://server.api.mailchimp.com/3.0
security:
- basicAuth: []
tags:
- name: landingPages
paths:
/landing-pages:
get:
description: Get all landing pages.
operationId: getAllLandingPages
parameters:
- name: sort_dir
x-title: Sort Direction
description: Determines the order direction for sorted results.
in: query
required: false
schema:
type: string
enum:
- ASC
- DESC
- name: sort_field
x-title: Sort By Field
description: Returns files sorted by the specified field.
in: query
required: false
schema:
type: string
enum:
- created_at
- updated_at
- name: fields
x-title: Fields
in: query
description: A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
required: false
style: form
explode: false
schema:
type: array
items:
type: string
- name: exclude_fields
x-title: Exclude Fields
in: query
description: A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
required: false
style: form
explode: false
schema:
type: array
items:
type: string
- name: count
x-title: Count
in: query
description: The number of records to return. Default value is 10. Maximum value is 1000
required: false
schema:
type: integer
default: 10
maximum: 1000
responses:
'200':
description: Landing Pages Collection
content:
application/json:
schema:
type: object
description: A collection of landing pages.
properties:
landing_pages:
type: array
description: The landing pages on the account
items:
type: object
title: Landing Page
description: A summary of an individual landing page's settings and content.
properties:
id:
type: string
title: Landing Page ID
description: A string that uniquely identifies this landing page.
readOnly: true
example: 030092c2e1f0
name:
type: string
title: Landing Page Name
description: The name of this landing page.
readOnly: false
title:
type: string
title: Landing Page title
description: The title of this landing page seen in the browser's title bar.
readOnly: false
description:
type: string
title: Landing Page description
description: The description of this landing page.
readOnly: false
template_id:
type: integer
title: Landing Page template_id
description: The template_id of this landing page.
readOnly: true
status:
type: string
title: Landing Page status
description: The status of this landing page.
enum:
- published
- unpublished
- draft
readOnly: true
list_id:
type: string
title: Landing Page list id
description: The list's ID associated with this landing page.
example: fde02ad86b
readOnly: false
store_id:
type: string
title: Store ID
description: The ID of the store associated with this landing page.
readOnly: false
web_id:
type: integer
title: Landing Page Web ID
description: The ID used in the Mailchimp web application.
created_by_source:
type: string
title: Created By Source
description: Created by mobile or web
readOnly: true
url:
type: string
title: Published url
description: The url of the published landing page.
readOnly: true
created_at:
type: string
title: Created At
description: The time this landing page was created.
format: date-time
readOnly: true
published_at:
type: string
title: Published at
description: The time this landing page was published.
format: date-time
readOnly: true
unpublished_at:
type: string
title: Unpublished at
description: The time this landing page was unpublished.
format: date-time
readOnly: true
updated_at:
type: string
title: Updated_at
description: The time this landing page was updated at.
format: date-time
readOnly: true
tracking:
type: object
title: Tracking Settings
description: The tracking settings applied to this landing page.
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/).
_links:
title: Links
description: A list of link types and descriptions for the API schema documents.
type: array
items:
type: object
title: Resource Link
description: This object represents a link from the resource where it is found to another resource or action that may be performed.
properties:
rel:
type: string
title: Rel
description: As with an HTML 'rel' attribute, this describes the type of link.
readOnly: true
href:
type: string
title: Href
description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
readOnly: true
method:
type: string
title: Method
description: The HTTP method that should be used when accessing the URL defined in 'href'.
enum:
- GET
- POST
- PUT
- PATCH
- DELETE
- OPTIONS
- HEAD
readOnly: true
targetSchema:
type: string
title: Target Schema
description: For GETs, this is a URL representing the schema that the response should conform to.
readOnly: true
schema:
type: string
title: Schema
description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
readOnly: true
readOnly: true
total_items:
type: integer
title: Item Count
description: The total number of items matching the query regardless of pagination.
readOnly: true
_links:
title: Links
description: A list of link types and descriptions for the API schema documents.
type: array
items:
type: object
title: Resource Link
description: This object represents a link from the resource where it is found to another resource or action that may be performed.
properties:
rel:
type: string
title: Rel
description: As with an HTML 'rel' attribute, this describes the type of link.
readOnly: true
href:
type: string
title: Href
description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
readOnly: true
method:
type: string
title: Method
description: The HTTP method that should be used when accessing the URL defined in 'href'.
enum:
- GET
- POST
- PUT
- PATCH
- DELETE
- OPTIONS
- HEAD
readOnly: true
targetSchema:
type: string
title: Target Schema
description: For GETs, this is a URL representing the schema that the response should conform to.
readOnly: true
schema:
type: string
title: Schema
description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
readOnly: true
readOnly: true
application/problem+json:
schema:
type: object
description: A collection of landing pages.
properties:
landing_pages:
type: array
description: The landing pages on the account
items:
type: object
title: Landing Page
description: A summary of an individual landing page's settings and content.
properties:
id:
type: string
title: Landing Page ID
description: A string that uniquely identifies this landing page.
readOnly: true
example: 030092c2e1f0
name:
type: string
title: Landing Page Name
description: The name of this landing page.
readOnly: false
title:
type: string
title: Landing Page title
description: The title of this landing page seen in the browser's title bar.
readOnly: false
description:
type: string
title: Landing Page description
description: The description of this landing page.
readOnly: false
template_id:
type: integer
title: Landing Page template_id
description: The template_id of this landing page.
readOnly: true
status:
type: string
title: Landing Page status
description: The status of this landing page.
enum:
- published
- unpublished
- draft
readOnly: true
list_id:
type: string
title: Landing Page list id
description: The list's ID associated with this landing page.
example: fde02ad86b
readOnly: false
store_id:
type: string
title: Store ID
description: The ID of the store associated with this landing page.
readOnly: false
web_id:
type: integer
title: Landing Page Web ID
description: The ID used in the Mailchimp web application.
created_by_source:
type: string
title: Created By Source
description: Created by mobile or web
readOnly: true
url:
type: string
title: Published url
description: The url of the published landing page.
readOnly: true
created_at:
type: string
title: Created At
description: The time this landing page was created.
format: date-time
readOnly: true
published_at:
type: string
title: Published at
description: The time this landing page was published.
format: date-time
readOnly: true
unpublished_at:
type: string
title: Unpublished at
description: The time this landing page was unpublished.
format: date-time
readOnly: true
updated_at:
type: string
title: Updated_at
description: The time this landing page was updated at.
format: date-time
readOnly: true
tracking:
type: object
title: Tracking Settings
description: The tracking settings applied to this landing page.
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/).
_links:
title: Links
description: A list of link types and descriptions for the API schema documents.
type: array
items:
type: object
title: Resource Link
description: This object represents a link from the resource where it is found to another resource or action that may be performed.
properties:
rel:
type: string
title: Rel
description: As with an HTML 'rel' attribute, this describes the type of link.
readOnly: true
href:
type: string
title: Href
description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
readOnly: true
method:
type: string
title: Method
description: The HTTP method that should be used when accessing the URL defined in 'href'.
enum:
- GET
- POST
- PUT
- PATCH
- DELETE
- OPTIONS
- HEAD
readOnly: true
targetSchema:
type: string
title: Target Schema
description: For GETs, this is a URL representing the schema that the response should conform to.
readOnly: true
schema:
type: string
title: Schema
description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
readOnly: true
readOnly: true
total_items:
type: integer
title: Item Count
description: The total number of items matching the query regardless of pagination.
readOnly: true
_links:
title: Links
description: A list of link types and descriptions for the API schema documents.
type: array
items:
type: object
title: Resource Link
description: This object represents a link from the resource where it is found to another resource or action that may be performed.
properties:
rel:
type: string
title: Rel
description: As with an HTML 'rel' attribute, this describes the type of link.
readOnly: true
href:
type: string
title: Href
description: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
readOnly: true
method:
type: string
title: Method
description: The HTTP method that should be used when accessing the URL defined in 'href'.
enum:
- GET
- POST
- PUT
- PATCH
- DELETE
- OPTIONS
- HEAD
readOnly: true
targetSchema:
type: string
title: Target Schema
description: For GETs, this is a URL representing the schema that the response should conform to.
readOnly: true
schema:
type: string
title: Schema
description: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
readOnly: true
readOnly: true
default:
description: An error generated by the Mailchimp API.
content:
application/json:
schema:
type: object
title: Problem Detail Document
description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
required:
- type
- title
- status
- detail
- instance
properties:
type:
type: string
title: Problem Type
description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
example: https://mailchimp.com/developer/marketing/docs/errors/
title:
type: string
title: Error Title
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.
example: Resource Not Found
status:
type: integer
title: HTTP Status Code
description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
example: 404
detail:
type: string
title: Error Message
description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
example: The requested resource could not be found.
instance:
type: string
title: Instance ID
description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
application/problem+json:
schema:
type: object
title: Problem Detail Document
description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
required:
- type
- title
- status
- detail
- instance
properties:
type:
type: string
title: Problem Type
description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
example: https://mailchimp.com/developer/marketing/docs/errors/
title:
type: string
title: Error Title
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.
example: Resource Not Found
status:
type: integer
title: HTTP Status Code
description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
example: 404
detail:
type: string
title: Error Message
description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
example: The requested resource could not be found.
instance:
type: string
title: Instance ID
description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
tags:
- landingPages
x-custom-config:
methodNameSnake: get_all
methodNameCamel: getAll
summary: List landing pages
post:
summary: Add landing page
description: Create an unpublished and contentless Mailchimp landing page.
parameters:
- in: query
name: use_default_list
x-title: Use Default List
required: false
description: Will create the Landing Page using the account's Default List instead of requiring a list_id.
schema:
type: boolean
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
title: Landing Page
description: A summary of an individual landing page's settings and content.
properties:
id:
type: string
title: Landing Page ID
description: A string that uniquely identifies this landing page.
readOnly: true
example: 030092c2e1f0
name:
type: string
title: Landing Page Name
description: The name of this landing page.
readOnly: false
title:
type: string
title: Landing Page title
description: The title of this landing page seen in the browser's title bar.
readOnly: false
description:
type: string
title: Landing Page description
description: The description of this landing page.
readOnly: false
template_id:
type: integer
title: Landing Page template_id
description: The template_id of this landing page.
readOnly: true
status:
type: string
title: Landing Page status
description: The status of this landing page.
enum:
- published
- unpublished
- draft
readOnly: true
list_id:
type: string
title: Landing Page list id
description: The list's ID associated with this landing page.
example: fde02ad86b
readOnly: false
store_id:
type: string
title: Store ID
description: The ID of the store associated with this landing page.
readOnly: false
web_id:
type: integer
title: Landing Page Web ID
description: The ID used in the Mailchimp web application.
created_by_source:
type: string
title: Created By Source
description: Created by mobile or web
readOnly: true
url:
type: string
title: Published url
description: The url of the published landing page.
readOnly: true
created_at:
type: string
title: Created At
description: The time this landing page was created.
format: date-time
readOnly: true
published_at:
type: string
title: Published at
description: The time this landing page was published.
format: date-time
readOnly: true
unpublished_at:
type: string
title: Unpublished at
description: The time this landing page was unpublished.
format: date-time
readOnly: true
updated_at:
type: string
title: Updated_at
description: The time this landing page was updated at.
format: date-time
readOnly: true
tracking:
type: object
title: Tracking Settings
description: The tracking settings applied to this landing page.
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/).
ena
# --- truncated at 32 KB (142 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-landingpages-api-openapi.yml