Constantcontact AppConnect V3
73
AI ReadinessAI-Aware (A-)73/100
Agent-ready OpenAPI document · curated by JenticMarketingEmail Marketingoauth2, apiKey116 EndpointsREST
Know of an official OpenAPI document? Contribute it →
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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fconstantcontact.com%2Fconstantcontact" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fconstantcontact.com%2Fconstantcontact" | 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 your Jentic One instance 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
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
A
AppConnect V3
- AI-Aware (A-)73/100
93
Foundational Compliance82
Developer Experience & Jentic Compatibility60
AI-Readiness & Agent Experience80
Agent Usability53
Security100
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
93
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
96%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
75%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
82
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: ASignals: 4
56%
Example Density
How richly the API is illustrated with examples.
99%
Example Validity
Percentage of examples that conform to their schemas.
75%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
60
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: C+Signals: 4
82%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
98%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
58%
Summary Coverage
Coverage of summaries across operations/tags/info.
80
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A-Signals: 1
80%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
53
Security
Trust, risk posture, and security compliance.
Grade: C-Signals: 1
53%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
100
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A+Signals: 1
100%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Constant Contact by hand means running the OAuth 2.0 flow, refreshing tokens, sending the partner x-api-key alongside them, and mapping the contact, email, and reporting calls yourself. Through Jentic you install once, import the AppConnect V3 API from the API Directory, store the credentials once, and your agent calls it.
Permission scoping
Constant Contact takes its contact and email targets in the request body, so you limit the agent to the operations it needs, such as reading contacts or listing campaign summaries, and it can call nothing outside that set. State-changing operations like creating contacts, importing contacts, or sending emails are only reachable if you include them in the allowed set.
Credential isolation
Your Constant Contact OAuth refresh token and partner x-api-key are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'read a campaign summary report' or 'list contacts', and Jentic returns the matching Constant Contact operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
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 with Jentic One, the self-hosted execution layer.
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 your Jentic One instance 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.
Can I limit what my agent is allowed to do with the Constant Contact API?
Yes. Because you run Jentic One yourself, your own rules decide which Constant Contact operations and credentials the agent may use, so you can grant it only read calls such as listing contacts or fetching campaign summary reports and it can reach nothing else. State-changing operations like creating a contact, running a bulk contact import, or scheduling and sending an email campaign are callable only if you include them in the allowed set. Since Constant Contact takes its contact and campaign targets in the request body, scoping the operation set is what keeps the agent inside the actions you intend.
GET STARTED