OAuth providers
Mailchimp
Set up Mailchimp OAuth for email marketing and audience management
Overview
Section titled “Overview”Connect your users to Mailchimp for email marketing campaigns, audience management, and subscriber data.
| Property | Value |
|---|---|
| Provider ID | mailchimp |
| Category | Marketing |
| PKCE | Not supported |
| Token refresh | Not supported (permanent tokens) |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Mailchimp OAuth App
Section titled “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.
Step 2: Add to Alter Vault
Section titled “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.
- 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.