Generated by API Evangelist
Written by API Evangelist tooling for Mailchimp's API. It is a proposal applied on top of the contract, not a document Mailchimp publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Mailchimp Marketing Surveys API
version: 1.0.0
extends: openapi/mailchimp-surveys-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 3
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/publish'].post
update:
x-apievangelist-phrasing:
intent: Publish a survey
effect: write
questions:
- How do I publish a draft survey so people can respond?
- Can I republish a survey after editing it?
instructions:
- text: Publish survey {survey_id} on audience {list_id}.
slots:
survey_id: path.survey_id
list_id: path.list_id
- text: Make survey {survey_id} for list {list_id} live.
slots:
survey_id: path.survey_id
list_id: path.list_id
method: generated
generated: '2026-09-26'
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/unpublish'].post
update:
x-apievangelist-phrasing:
intent: Unpublish a survey
effect: write
questions:
- How do I take a published survey offline?
- Can I stop accepting responses to a survey?
instructions:
- text: Unpublish survey {survey_id} on audience {list_id}.
slots:
survey_id: path.survey_id
list_id: path.list_id
- text: Take survey {survey_id} for list {list_id} offline.
slots:
survey_id: path.survey_id
list_id: path.list_id
method: generated
generated: '2026-09-26'
- target: $.paths['/lists/{list_id}/surveys/{survey_id}/actions/create-email'].post
update:
x-apievangelist-phrasing:
intent: Create a campaign that links to a survey
effect: write
questions:
- How do I create an email campaign that sends people to my survey?
- Can I generate a survey invitation campaign automatically?
instructions:
- text: Create a campaign linking to survey {survey_id} for audience {list_id}.
slots:
survey_id: path.survey_id
list_id: path.list_id
- text: Build an email that invites list {list_id} to take survey {survey_id}.
slots:
list_id: path.list_id
survey_id: path.survey_id
method: generated
generated: '2026-09-26'
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.