基础URL

https://gateway.maton.ai/lemlist/api/{resource}

将{resource}替换为实际的Lemlist API端点路径。该网关将请求代理到api.lemlist.com/api，并自动注入您的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管理您的Lemlist OAuth连接。

列出连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=lemlist&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: lemlist}).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: 3ecf268f-42ad-40cc-b77a-25e020fbf591,
status: ACTIVE,
creation_time: 2026-02-12T02:00:53.023887Z,
lastupdatedtime: 2026-02-12T02:01:45.284131Z,
url: https://connect.maton.ai/?session_token=...,
app: lemlist,
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

指定连接

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

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/lemlist/api/campaigns)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 3ecf268f-42ad-40cc-b77a-25e020fbf591)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

API参考

团队

获取团队

bash
GET /lemlist/api/team

返回团队信息，包括用户ID和设置。

获取团队积分

bash
GET /lemlist/api/team/credits

返回剩余积分余额。

获取团队发件人

bash
GET /lemlist/api/team/senders

返回所有团队成员及其关联的营销活动。

营销活动

列出营销活动

bash
GET /lemlist/api/campaigns

创建营销活动

bash
POST /lemlist/api/campaigns
Content-Type: application/json

{
name: 我的营销活动
}

创建一个新的营销活动，并自动添加空序列和默认日程。

获取营销活动

bash
GET /lemlist/api/campaigns/{campaignId}

更新营销活动

bash
PATCH /lemlist/api/campaigns/{campaignId}
Content-Type: application/json

{
name: 已更新的营销活动名称
}

暂停营销活动

bash
POST /lemlist/api/campaigns/{campaignId}/pause

暂停正在运行的营销活动。

营销活动序列

获取营销活动序列

bash
GET /lemlist/api/campaigns/{campaignId}/sequences

返回营销活动的所有序列和步骤。

营销活动日程

获取营销活动日程

bash
GET /lemlist/api/campaigns/{campaignId}/schedules

返回与营销活动关联的所有日程。

线索

向营销活动添加线索

bash
POST /lemlist/api/campaigns/{campaignId}/leads
Content-Type: application/json

{
email: lead@example.com,
firstName: John,
lastName: Doe,
companyName: Acme Inc
}

创建新线索并将其添加到营销活动中。如果线索已存在，则将其插入到营销活动中。

按邮箱获取线索

bash
GET /lemlist/api/leads/{email}

更新营销活动中的线索

bash
PATCH /lemlist/api/campaigns/{campaignId}/leads/{email}
Content-Type: application/json

{
firstName: Jane,
lastName: Smith
}

从营销活动中删除线索

bash
DELETE /lemlist/api/campaigns/{campaignId}/leads/{email}

活动

列出活动

bash
GET /lemlist/api/activities

返回营销活动历史记录（最近100条活动）。

查询参数：

• - campaignId - 按营销活动筛选
• type - 按活动类型筛选（emailsSent、emailsOpened、emailsClicked等）

日程

列出日程

bash
GET /lemlist/api/schedules

返回所有日程，支持分页。

响应：
json
{
schedules: [...],
pagination: {
totalRecords: 10,
currentPage: 1,
nextPage: 2,
totalPage: 2
}
}

创建日程

bash
POST /lemlist/api/schedules
Content-Type: application/json

{
name: 工作时间,
timezone: America/New_York,
start: 09:00,
end: 17:00,
weekdays: [1, 2, 3, 4, 5]
}

工作日：0 = 星期日，1 = 星期一，...，6 = 星期六

获取日程

bash
GET /lemlist/api/schedules/{scheduleId}

更新日程

bash
PATCH /lemlist/api/schedules/{scheduleId}
Content-Type: application/json

{
name: 已更新的日程,
start: 08:00,
end: 18:00
}

删除日程

bash
DELETE /lemlist/api/schedules/{scheduleId}

公司

列出公司

bash
GET /lemlist/api/companies

返回公司列表，支持分页。

响应：
json
{
data: [...],
total: 100
}

退订

列出退订

bash
GET /leml