Constantcontact AppConnect V3
★ Only Publicly Available OpenAPI DocumentMarketingEmail Marketingoauth2, apiKey116 EndpointsREST
For Agents
Manage Constant Contact email marketing programs: create and segment contacts, send and report on email campaigns, schedule sends, and run bulk contact activities through 116 endpoints.
Use for: I need to add a new contact to a Constant Contact list, I want to launch a scheduled email campaign to a segment, Find all contacts that opened a specific email campaign, Set up an A/B test for a Constant Contact email subject line
Not supported: Does not handle transactional email, SMS sending, or CRM deal pipelines — use for Constant Contact marketing email, contact, and event management only.
Jentic publishes the only available OpenAPI specification for AppConnect V3, keeping it validated and agent-ready. The Constant Contact V3 API lets developers build integrations with the small-business email marketing platform, covering contacts, contact lists and tags, custom fields, segments, email campaigns and A/B tests, scheduling, reporting, events, and partner webhooks. Authentication uses OAuth 2.0 with scoped permissions for contact and campaign data alongside an x-api-key header for partner identification. The 116 endpoints span 17 resource groups and support both interactive contact management and bulk activities such as contact imports, list membership changes, and tagging operations.
Install Jentic One Beta
Connect the AppConnect V3 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AppConnect V3, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with AppConnect V3 API.
Create, update, and segment contacts across lists, tags, and custom fields
Build, schedule, and A/B test email campaigns with HTML and template content
Run bulk activities including contact imports, exports, deletions, and list membership changes
Pull engagement reports for email campaigns, contacts, landing pages, and SMS
Register webhooks so partner applications receive contact and campaign event notifications
Manage event registrations across event tracks and registration records
Read account summary, sender email addresses, and user privileges for the connected account
Use Cases
Patterns agents use AppConnect V3 API for, with concrete tasks.
★ Bulk Contact Import and Segmentation
Import contact lists from a CRM or spreadsheet into Constant Contact, then organise contacts into lists, tags, and custom fields so that future campaigns can target the right audience. The V3 API exposes JSON and file-based bulk import activities that run asynchronously, returning an activity id that can be polled until completion. Integration time is hours rather than days because list memberships, tags, and custom fields can be updated in bulk through dedicated activity endpoints.
Import 1,200 contacts from a CSV by calling the contacts_file_import activity, poll the activity id until status is complete, then add the imported contacts to list 'Newsletter Subscribers'
Email Campaign Send and Reporting
Create an email campaign, schedule it for a future send time, and pull open, click, bounce, and unsubscribe metrics once the campaign has been delivered. The Email Campaigns and Email Reporting groups expose draft creation, scheduling, and per-campaign engagement reporting so reporting dashboards and CRMs can consume Constant Contact metrics. Reporting endpoints return aggregated counts that can be mapped to a customer activity timeline.
Create an email campaign named 'June Newsletter', schedule it to send on 2026-06-15 at 10:00 UTC to list 'Newsletter Subscribers', and after 24 hours retrieve the campaign's tracking activity
Partner Webhook Integration
Technology partners can register webhooks so that contact updates, list changes, and campaign events flow to an external system in near real time. The API exposes Technology Partners Webhooks endpoints to subscribe to topics, manage subscriptions, and authenticate callbacks. This avoids polling and reduces sync latency for partner platforms that resell or embed Constant Contact.
Register a webhook for the contact_create and contact_update topics that POSTs to https://example.com/cc-webhook with HMAC verification
AI Agent Marketing Operator via Jentic
An AI agent can run a small business's email marketing operation by combining Constant Contact's contact, campaign, and reporting endpoints discovered through Jentic. The agent searches Jentic for the operation it needs, loads the input schema, and executes against Constant Contact without storing OAuth tokens in its context. Jentic's MAXsystem holds the OAuth credentials and returns scoped access for each call, making this safe to run from a multi-tenant agent.
Search Jentic for 'create a constant contact email campaign', load the schema, and execute a draft campaign for list 'Q3 Customers' with subject 'Summer Update' and HTML body from the latest blog post
Key Endpoints
116 endpoints — jentic publishes the only available openapi specification for appconnect v3, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/contacts
List or search contacts
POST
/contacts
Create a contact
POST
/activities/contacts_json_import
Bulk import contacts from JSON
POST
/emails
Create an email campaign
POST
/emails/activities
Schedule or send an email campaign activity
GET
/reports/summary_reports/email_campaign_summaries
Get aggregated email campaign engagement reports
GET
/contact_lists
List contact lists
GET
/account/summary
Get account summary and sender details
GET
/contacts
List or search contacts
POST
/contacts
Create a contact
POST
/activities/contacts_json_import
Bulk import contacts from JSON
POST
/emails
Create an email campaign
POST
/emails/activities
Schedule or send an email campaign activity
GET
/reports/summary_reports/email_campaign_summaries
Get aggregated email campaign engagement reports
GET
/contact_lists
List contact lists
GET
/account/summary
Get account summary and sender details
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Constant Contact OAuth refresh tokens and the partner x-api-key are stored encrypted in the Jentic vault (MAXsystem). Agents receive short-lived scoped access tokens only when an operation runs, so neither the refresh token nor the partner key enters agent context.
Intent-based discovery
Agents search Jentic by intent (e.g. 'send a constant contact email campaign') and Jentic returns the matching operation from this spec along with its input schema, so the agent calls the right endpoint without crawling Constant Contact's developer portal.
Time to first call
Direct Constant Contact integration: 2-4 days for OAuth, scope handling, bulk-activity polling, and webhook signature verification. Through Jentic: under an hour to search, load schema, and execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using AppConnect V3 API through Jentic.
Why is there no official OpenAPI spec for AppConnect V3?
Constant Contact does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call AppConnect V3 via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the AppConnect V3 API use?
The API uses OAuth 2.0 with both authorization code and implicit flows scoped to contact_data, campaign_data, account_read, and account_update, plus an x-api-key header for partner identification. Through Jentic the OAuth refresh token is held in the MAXsystem vault and the agent only ever sees a short-lived scoped access token at call time.
Can I run bulk contact imports with the AppConnect V3 API?
Yes. POST to /activities/contacts_json_import or /activities/contacts_file_import to enqueue an import activity, then poll /activities/{activity_id} until status is complete. The same Bulk Activities group also supports contact deletes, list membership changes, and tag add/remove.
What are the rate limits for the AppConnect V3 API?
Constant Contact applies per-application rate limits that vary by endpoint and partner tier; limits and current usage are returned in response headers and documented in Constant Contact's developer portal. Through Jentic, retries with exponential backoff are handled at the SDK level so agents do not need to implement throttling logic themselves.
How do I send an email campaign with the AppConnect V3 API through Jentic?
Run `jentic.search('create a constant contact email campaign')`, load the returned operation, and execute with the campaign name, list ids, subject, and HTML body. Jentic resolves this to POST /emails to create the draft and POST /emails/activities to schedule the send.
Does the AppConnect V3 API support A/B testing email subject lines?
Yes. The Email Campaigns AB Tests resource group exposes endpoints to create A/B subject line tests, configure test winner criteria, and retrieve test results once the campaign has run.
GET STARTED