Mailchimp

Overview

Connect your users to Mailchimp for email marketing campaigns, audience management, and subscriber data.

Property	Value
Provider ID	mailchimp
Category	Business
PKCE	Not supported
Token refresh	Not supported (permanent tokens)
Redirect URI	Shown in Developer Portal

Step 1: Create a Mailchimp OAuth App

Go to the Mailchimp OAuth2 page

Navigate to admin.mailchimp.com/account/oauth2 and sign in.

Register a new application

Click Register App and fill in the application name, description, and website URL.

Configure the redirect URI

Enter the Alter callback URL from the Developer Portal as the Redirect URI.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Mailchimp provider

Go to OAuth Providers > Add Provider > Mailchimp.

Enter credentials

• Client ID: Paste your Mailchimp Client ID
• Client Secret: Paste your Mailchimp Client Secret

Save

Click Save. The provider is now active.

Notes

• Mailchimp issues permanent (non-expiring) access tokens. There is no refresh token flow.
• No scope selection is required — the token grants access to all Mailchimp API endpoints for the authenticated user.
• Mailchimp uses a data center suffix in API URLs (e.g., us1). The API base URL is returned in the metadata endpoint after authorization.
• See the Mailchimp OAuth2 guide for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
patchAutomationEmailWorkflowId	send	PATCH	/automations/{workflow_id}/emails/{workflow_email_id}
patchCampaignsIdFeedbackId	send	PATCH	/campaigns/{campaign_id}/feedback/{feedback_id}
postAutomationsIdEmailsIdActionsPause	send	POST	/automations/{workflow_id}/emails/{workflow_email_id}/actions/pause
postAutomationsIdEmailsIdActionsStart	send	POST	/automations/{workflow_id}/emails/{workflow_email_id}/actions/start
postAutomationsIdEmailsIdQueue	send	POST	/automations/{workflow_id}/emails/{workflow_email_id}/queue
postCampaignsIdActionsCancelSend	delete, send	POST	/campaigns/{campaign_id}/actions/cancel-send
postCampaignsIdActionsCreateResend	send	POST	/campaigns/{campaign_id}/actions/create-resend
postCampaignsIdActionsSend	send	POST	/campaigns/{campaign_id}/actions/send
deleteEcommerceStoresIdOrdersId	delete, payment	DELETE	/ecommerce/stores/{store_id}/orders/{order_id}
deleteEcommerceStoresIdOrdersIdLinesId	delete, payment	DELETE	/ecommerce/stores/{store_id}/orders/{order_id}/lines/{line_id}
patchEcommerceStoresIdOrdersId	payment	PATCH	/ecommerce/stores/{store_id}/orders/{order_id}
patchEcommerceStoresIdOrdersIdLinesId	payment	PATCH	/ecommerce/stores/{store_id}/orders/{order_id}/lines/{line_id}
postEcommerceStoresIdOrders	payment	POST	/ecommerce/stores/{store_id}/orders
postEcommerceStoresIdOrdersIdLines	payment	POST	/ecommerce/stores/{store_id}/orders/{order_id}/lines
putEcommerceStoresIdOrdersId	payment	PUT	/ecommerce/stores/{store_id}/orders/{order_id}
deleteAutomationsIdEmailsId	delete	DELETE	/automations/{workflow_id}/emails/{workflow_email_id}
deleteBatchWebhookId	admin, delete	DELETE	/batch-webhooks/{batch_webhook_id}
deleteBatchesId	delete	DELETE	/batches/{batch_id}
deleteCampaignFoldersId	delete	DELETE	/campaign-folders/{folder_id}
deleteCampaignsId	delete	DELETE	/campaigns/{campaign_id}
deleteCampaignsIdFeedbackId	delete	DELETE	/campaigns/{campaign_id}/feedback/{feedback_id}
deleteConnectedSitesId	delete	DELETE	/connected-sites/{connected_site_id}
deleteEcommerceStoresId	delete	DELETE	/ecommerce/stores/{store_id}
deleteEcommerceStoresIdCartsId	delete	DELETE	/ecommerce/stores/{store_id}/carts/{cart_id}
deleteEcommerceStoresIdCartsLinesId	delete	DELETE	/ecommerce/stores/{store_id}/carts/{cart_id}/lines/{line_id}
patchBatchWebhooks	admin, write	PATCH	/batch-webhooks/{batch_webhook_id}
patchListsIdMembersId	admin, write	PATCH	/lists/{list_id}/members/{subscriber_hash}
patchListsIdMembersIdNotesId	admin, write	PATCH	/lists/{list_id}/members/{subscriber_hash}/notes/{note_id}
patchListsIdWebhooksId	admin, write	PATCH	/lists/{list_id}/webhooks/{webhook_id}
postListMemberEvents	admin, write	POST	/lists/{list_id}/members/{subscriber_hash}/events
createAudienceContact	write	POST	/audiences/{audience_id}/contacts
patchAudienceContact	write	PATCH	/audiences/{audience_id}/contacts/{contact_id}
patchEcommerceStoresIdCustomersId	write	PATCH	/ecommerce/stores/{store_id}/customers/{customer_id}
patchFileManagerFilesId	write	PATCH	/file-manager/files/{file_id}
patchFileManagerFoldersId	write	PATCH	/file-manager/folders/{folder_id}
postAudiencesContactsActionsForget	write	POST	/audiences/{audience_id}/contacts/{contact_id}/actions/forget
postAutomationsIdActionsPauseAllEmails	write	POST	/automations/{workflow_id}/actions/pause-all-emails
postAutomationsIdActionsStartAllEmails	write	POST	/automations/{workflow_id}/actions/start-all-emails
getAudienceContact	read	GET	/audiences/{audience_id}/contacts/{contact_id}
getAudienceContactList	read	GET	/audiences/{audience_id}/contacts
getAutomationsIdEmails	read	GET	/automations/{workflow_id}/emails
getAutomationsIdEmailsId	read	GET	/automations/{workflow_id}/emails/{workflow_email_id}
getAutomationsIdEmailsIdQueue	read	GET	/automations/{workflow_id}/emails/{workflow_email_id}/queue
getAutomationsIdEmailsIdQueueId	read	GET	/automations/{workflow_id}/emails/{workflow_email_id}/queue/{subscriber_hash}