基础URL

https://gateway.maton.ai/constant-contact/v3/{resource}

网关将请求代理到api.cc.email/v3，并自动注入您的OAuth令牌。

认证

所有请求都需要在Authorization头中携带Maton API密钥：

Authorization: Bearer $MATONAPIKEY

环境变量： 将您的API密钥设置为MATONAPIKEY：

bash
export MATONAPIKEY=YOURAPIKEY

获取您的API密钥

1. 1. 登录或创建账户：maton.ai
2. 前往 maton.ai/settings
3. 复制您的API密钥

连接管理

在 https://ctrl.maton.ai 管理您的Constant Contact OAuth连接。

列出连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=constant-contact&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

bash
python < import urllib.request, os, json
data = json.dumps({app: constant-contact}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：
json
{
connection: {
connection_id: 4314bd0f-fd56-40ab-8c65-2676dd2c23c4,
status: ACTIVE,
creation_time: 2026-02-07T07:41:05.859244Z,
lastupdatedtime: 2026-02-07T07:41:32.658230Z,
url: https://connect.maton.ai/?session_token=...,
app: constant-contact,
metadata: {}
}
}

在浏览器中打开返回的url以完成OAuth授权。

删除连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

如果您有多个Constant Contact连接，请使用Maton-Connection头指定要使用的连接：

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/constant-contact/v3/contacts)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 4314bd0f-fd56-40ab-8c65-2676dd2c23c4)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

如果省略，网关将使用默认（最旧）的活动连接。

API参考

账户

获取账户摘要

bash
GET /constant-contact/v3/account/summary

获取账户邮箱

bash
GET /constant-contact/v3/account/emails

获取用户权限

bash
GET /constant-contact/v3/account/user/privileges

联系人

列出联系人

bash
GET /constant-contact/v3/contacts

查询参数：

• - status - 按状态筛选：all、active、deleted、notset、pendingconfirmation、temphold、unsubscribed
• email - 按邮箱地址筛选
• lists - 按列表ID筛选
• segmentid - 按细分群体ID筛选
• tags - 按标签ID筛选
• updatedafter - ISO-8601日期筛选
• include - 包含子资源：customfields、list_memberships、taggings、notes
• limit - 每页结果数（默认50，最大500）

获取联系人

bash
GET /constant-contact/v3/contacts/{contact_id}

创建联系人

bash
POST /constant-contact/v3/contacts
Content-Type: application/json

{
email_address: {
address: john@example.com,
permissiontosend: implicit
},
first_name: John,
last_name: Doe,
job_title: Developer,
company_name: Acme Inc,
list_memberships: [list-uuid-here]
}

更新联系人

bash
PUT /constant-contact/v3/contacts/{contact_id}
Content-Type: application/json

{
email_address: {
address: john@example.com
},
first_name: John,
last_name: Smith
}

删除联系人

bash
DELETE /constant-contact/v3/contacts/{contact_id}

创建或更新联系人（注册表单）

使用此端点创建新联系人或在无需先检查是否存在的情况下更新现有联系人：

bash
POST /constant-contact/v3/contacts/signupform
Content-Type: application/json

{
email_address: john@example.com,
first_name: John,
last_name: Doe,
list_memberships: [list-uuid-here]
}

获取联系人计数

bash
GET /constant-contact/v3/contacts/counts

联系人列表

列出联系人列表

bash
GET /constant-contact/v3/contact_lists

查询参数：

• - includecount - 包含每个列表的联系人数量
• includemembership_count - 包含成员数量
• limit - 每页结果数

获取联系人列表

bash
GET /constant-contact/v3/contactlists/{listid}

创建联系人列表

bash
POST /constant-contact/v3/contact_lists
Content-Type: application/json

{
name: Newsletter Subscribers,
description: Main newsletter list,
favorite: false
}

更新联系人列表

bash
PUT /constant-contact/v3/contactlists/{listid}
Content-Type: application/json

{
name: Updated List Name,
description: Updated description,
favorite: true
}

删除联系人列表

bash
DELETE /constant-contact/v3/contactlists/{listid}

标签

列出标签

bash
GET /constant-contact/v3/contact_tags

创建标签

bash
POST /constant-contact/v3/contact_tags
Content-Type: application/json

{
name: VIP Customer
}

更新标签

bash
PUT /constant-contact/v3/contacttags/{tagid}
Content-Type: application/json

{
name: Premium Customer
}

删除标签

bash
DELETE /constant-contact/v3/contacttags/{tagid}

自定义字段

列出自定义字段

bash
GET /constant-contact/v3/contactcustomfields

创建自定义字段

bash
POST /constant-contact/v3/contactcustomfields
Content-Type: application/json

{
label: Customer ID,
type: string
}

删除自定义字段

bash
DELETE /constant-contact/v3/contactcustomfields/{customfieldid}

邮件营销