How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Constant Contact Contacts API

Endpoints and methods to get, create, delete, and update one or more contacts.

Constant Contact Contacts API is one of 19 APIs that Constant Contact publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contacts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 10 operations across 7 paths, and defines 29 schemas. It is described by OpenAPI 3.2.0, at version 3.0.178.

Requests are made against a single base URL, https://api.cc.email/v3.

10 operations 7 paths 29 schemas 1 DELETE5 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.0.178
Base URL
https://api.cc.email/v3
Authentication
OAuth 2.0, OAuth 2.0, OAuth 2.0, API Key
Contact
webservices@constantcontact.com
License
Resource Areas
1

Authentication & Security 4

Constant Contact Contacts API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2_implicit) using the implicit flow, exposing 5 scopes. It supports OAuth 2.0 (oauth2_access_code) using the authorizationCode flow, exposing 5 scopes. It supports OAuth 2.0 (ctctPartnerAuthorizer) using the implicit flow, exposing 1 scope. An API key is passed in the header as x-api-key (api_key).

  • ctctPartnerAuthorizer — Partner Authentication

Paths & Operations 10

Across 7 paths, the API surfaces 10 operations — 1 DELETE, 5 GET, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Contacts 10

Endpoints and methods to get, create, delete, and update one or more contacts.

GET
/contacts/{contact_id}
GET a Contact
getContact 2 params → 200400401403404500503
PUT
/contacts/{contact_id}
PUT (update) a Contact
putContact 1 param body → 200400401403404409500503
DELETE
/contacts/{contact_id}
DELETE a Contact
deleteContact 1 param → 204400401403404415500503
GET
/contacts
GET Contacts Collection
getContacts 15 params → 200202400401403404500503
POST
/contacts
POST (create) a Contact
createContact body → 201400401403409415500503
POST
/contacts/sign_up_form
Create or Update a Contact
createOrUpdateContact body → 200201400401403404409500
GET
/contacts/contact_id_xrefs
GET a collection of V2 and V3 API contact IDs
getContactIdXrefs 1 param → 200400401403404500503
GET
/contacts/sms_engagement_history/{contact_id}
GET SMS Engagement History for a Contact
getSmsEngagementHistory 1 param → 200400401403404500503
GET
/contacts/counts
GET Contact Consent Counts
countContact 1 param → 200400401403404500503
PUT
/contacts/resubscribe/{contact_id}
PUT Resubscribe a Contact
resubscribeContact 1 param body → 200400401403404409500503

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are ContactResource (21 properties), ContactPostRequest (16 properties), ContactPutRequest (16 properties), ContactCreateOrUpdateInput (13 properties). Each schema is shown below with its type and property counts.

EmailAddressPut
object
The contact's email address and related properties.
9 properties 1 required
ContactPostRequest
object
16 properties
Note
object
A note about the contact.
3 properties
StreetAddress
object
9 properties 1 required
Contacts
object
Use this endpoint to retrieve (GET) a collection of existing contacts, or to create (POST) a new contact.
4 properties
CreateOrUpdateContactCustomField
object
2 properties
ContactXrefs
object
1 property
SmsChannelConsentDetails
object
Provides SMS consent details.
8 properties
StreetAddressPut
object
6 properties 1 required
PhoneNumber
object
7 properties
ContactCreateOrUpdateInput
object
13 properties 1 required
ContactsCounts
object
6 properties
ContactResubscribeRequest
object
1 property 1 required
PagingLinks
object
1 property
ContactResource
object
Use this endpoint to retrieve (GET), update (PUT), or DELETE an existing contact resource specified using the contactid path parameter.
21 properties
HistoryDetails
object
Additional details about the SMS consent actions (opt-in, opt-out) in JSON format. The consentactiontype and the method used to add or update a contacts SMS de…
10 properties
PhoneNumberPut
object
2 properties
ContactSmsChannelConsents
object
3 properties 2 required
ContactSmsChannel
object
2 properties 2 required
JmmlSmsChannelConsents
object
7 properties 5 required
ContactXref
object
The cross-referenced pair of V3 API listid and V2 API sequenceid for a list. Response is sorted ascending by sequenceid .
2 properties
EmailAddress
object
A contact subresource describing the contact's email address.
10 properties 1 required
Link
object
1 property
ContactCustomField
object
Custom fields allow Constant Contact users to add custom content to a contact that can be used to personalize emails in addition to the standard set of variabl…
3 properties 1 required
SmsEngagementHistory
array
ContactCreateOrUpdateResponse
object
2 properties
ContactPutRequest
object
16 properties 1 required
JmmlSmsChannel
object
The contact's SMS details.
4 properties 4 required
EmailAddressPost
object
The contact's email address and related properties.
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

constant-contact-contacts-api-openapi.yml Raw ↑

Other APIs Constant Contact publishes across the network.

Constant Contact Account Services API
Constant Contact Bulk Activities API
Constant Contact Contact Lists API
Constant Contact Contact Tags API
Constant Contact Contacts Custom Fields API
Constant Contact Contacts Reporting API
Constant Contact Email Campaigns AB Tests API
Constant Contact Email Campaigns API
Constant Contact Email Reporting API
Constant Contact Email Scheduling API
Constant Contact Events API
Constant Contact Landing Pages Reporting API
Where this information came from

This is an independent, third-party profile of Constant Contact Contacts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.