Constant Contact
Connect Constant Contact to manage contacts, lists and tags, build and send email campaigns, run events and automations, and track opens and clicks.
You paste the API Key (client ID) and a generated client secret of an app you create in Constant Contact's V3 developer portal, then sign in to Constant Contact and approve access.
App review before this connector works
A new Constant Contact V3 app is private: only the Constant Contact user who created it can authorize it. Connecting your own account works the moment the app exists, but Constant Contact must approve the app before any other account can sign in through it.
- Typical wait
- Not published. Constant Contact's developer guide says only to contact support to start the approval process and gives no timeframe, so treat any figure you see elsewhere as unofficial.
- Cost
- Constant Contact's developer guide lists no fee for creating an app or for its approval. You need a Constant Contact account to sign in to the developer portal.
- Blocked until approved
- Signing in any Constant Contact account other than the one that created the app. Your own account is not blocked. An agency that wants to connect several client accounts through one app is blocked until approval, and a sign-in with any other account fails.
- Works meanwhile
- Everything for your own account: create the app, add PopMCP's Redirect URI, generate the client secret and connect. Every tool works straight away for the account that created the app. Other accounts can each create their own app and connect without waiting for approval.
Where to apply: Create the app under My Applications in the developer portal (app.constantcontact.com/pages/dma/portal), then call Constant Contact support on 866-289-2101 and ask them to start the approval process for that app.
- Create the app while signed in to the account you want to connect, because that is the only account an unapproved app can authorize.
- The 10,000 requests per day and 4 per second limit belongs to the app's API key, so every account connected through one app shares that budget.
- The client secret is shown once. Generating a new one replaces the old secret, and connections made with the old one need to be reconnected.
- A developer can register at most 50 applications.
- Approval does not change what a signed-in user may see: Constant Contact still limits some user roles regardless of the scopes an app asks for.
- Setup time
- 5 min
- Auth
- OAuth authorization
- API base URL
- https://api.cc.email/v3
- Rate limits
- 10,000 requests per day and 4 requests per second per API key (your app), shared by every account connected through it. The daily count resets at 00:00 UTC, and a 429 names quota_exceeded or throttled.
Before you begin
- A Constant Contact account you can sign in to. Create the app while signed in to the account you want to connect: until Constant Contact approves an app, only the user who created it can authorize it.
- PopMCP's Redirect URI from the connect form: https://app.popmcp.com/api/providers/constant-contact/callback
- A user role that can reach the data you want. Constant Contact limits some user roles regardless of the permissions an app asks for.
Get your credentials
Open My Applications
Go to app.constantcontact.com/pages/dma/portal and sign in with the Constant Contact account you want to connect. The My Applications page lists your apps. Click New Application.
My Applications
Applications registered to call the V3 API.
| Applications | API Key | |
|---|---|---|
| Website signup syncAuthorization Code Flow | 6f2a****-****-****-****-****91c4 | edit |
A developer account can hold up to 50 applications.
Create the application
Enter a name your users will recognize, such as PopMCP: Constant Contact shows it when asking for access. Choose Authorization Code Flow and Implicit Flow, choose Long Lived Refresh Tokens (Rotating Refresh works too), and click Create.
My Applications
Pick one OAuth2 flow and one refresh token type.
Add PopMCP's Redirect URI
Back on My Applications, click edit next to the new app. In the Redirect URI section add https://app.popmcp.com/api/providers/constant-contact/callback exactly as PopMCP shows it, then click Save.
PopMCP
Details
Constant Contact does not accept wildcards or URI fragments, so the address must match character for character.
Copy the API Key and generate a client secret
On the app's Details view, copy the API Key. Click Generate Client Secret and copy the secret straight away: Constant Contact shows it once, and generating another one replaces it. Click Save.
PopMCP
Details
- API Key
- b3d1****-****-****-****-****7a20
- OAuth2 flow
- Authorization Code Flow and Implicit Flow
- Refresh tokens
- Long Lived Refresh Tokens
The full secret is shown only right after you generate it.
Paste both into PopMCP and sign in
Paste the API Key into API key (client ID) and the secret into Client secret, then click Sign in with Constant Contact. Sign in with the same account that created the app and approve access.
Connect in PopMCP
Open your workspace, choose Constant Contact in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API key (client ID)text | Only needed to use your own app. In Constant Contact's developer portal (app.constantcontact.com/pages/dma/portal) choose New Application, pick "Authorization Code Flow and Implicit Flow" and "Long Lived Refresh Tokens", add the redirect URI shown here, then copy the API Key and generate a client secret. |
| Client secretsecret | Generate it on the app's page (Constant Contact shows it once). Stored encrypted and used only on our server.Encrypted with AES-256-GCM on save and never shown again. |
https://app.popmcp.com/api/providers/constant-contact/callbackAdd this exact URL under Redirect URIs on your app's page in the Constant Contact developer portal. It must match exactly, or Constant Contact refuses the sign-in.
PopMCP verifies the credential against Constant Contact immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Permissions PopMCP requests
These are the scopes sent to Constant Contact at authorization time.
| Scope | Why PopMCP asks for it |
|---|---|
| account_read | Reads the account summary, sender addresses and user privileges. PopMCP reads the account summary when you connect to record which account the sign-in is for, so the connection fails without it. |
| contact_data | Reads and writes contacts, lists, tags, custom fields and segments, runs bulk imports, exports and list or tag changes, and reads contact reports. Without it every contact and list tool answers 403. |
| campaign_data | Reads and writes email campaigns, test sends, scheduling, A/B tests and resends, and reads email campaign reports such as opens and clicks. |
| offline_access | Makes Constant Contact issue a refresh token. Without it the connection stops working once the access token expires, within a day. |
| account_update | Changes account details, such as adding a sender email address or updating the physical address campaigns print in their footer. |
Verify it worked
PopMCP shows Constant Contact as Connected under your organization name, and constant_contact_get_account_summary returns that account's organization_name and contact_email.
Troubleshooting
"Constant Contact did not accept the app's API key and client secret"
Why: Constant Contact answered invalid_client: the API Key or secret was mistyped, or a newer secret was generated after you copied this one.
Fix: Open the app on **My Applications**, click **Generate Client Secret**, click **Save**, and paste the new secret and the **API Key** into PopMCP again.
Constant Contact shows a redirect_uri error instead of the sign-in page
Why: PopMCP's callback is not registered under **Redirect URI** on the app, or differs by a character.
Fix: Add `https://app.popmcp.com/api/providers/constant-contact/callback` under **Redirect URI**, click **Save**, and connect again.
"Constant Contact signed in but refused to read the account"
Why: You signed in with an account other than the one that created the app, and Constant Contact has not approved the app yet, or not every permission was approved.
Fix: Sign in with the account that created the app and approve every permission. To connect other accounts through this app, call Constant Contact support on 866-289-2101 to start the approval process.
"Constant Contact's authorization code expired before it could be used"
Why: Authorization codes last 5 minutes and work once.
Fix: Start the connection again and finish the sign-in without leaving the page open.
"Constant Contact signed in but issued no refresh token"
Why: The sign-in did not grant offline_access, so the connection would stop within a day.
Fix: Connect again and approve every permission on the consent screen.
429 with quota_exceeded or throttled
Why: Your app's API key used its 10,000 requests for the day (quota_exceeded) or went over 4 requests a second (throttled). Every account connected through the app shares the same budget.
Fix: Wait for the daily reset at 00:00 UTC, or spread calls out. Bulk tools such as import_contacts_json and export_contacts_csv do in one request what would take hundreds of single calls.
"Constant Contact no longer accepts this sign-in"
Why: Access was revoked, the app or its secret changed, or the refresh token expired after 180 days unused.
Fix: Reconnect Constant Contact to sign in again.
Reference
Campaign Monitor
Connect Campaign Monitor to manage lists, subscribers and segments, build and send campaigns, track opens and clicks, and send transactional email.
Customer.io
Connect Customer.io to manage people and segments, run campaigns and broadcasts, send transactional messages, and track delivery performance.