用途:Mailtrap 联系人管理用于维护营销数据库,包括列表、分段、自定义字段和导入,为营销活动受众及相关流程提供依据。可通过 UI 或 API 完成创建、更新、批量导入、CRM/CDP 同步等操作。
主要能力:支持单个联系人创建/获取/更新/删除、批量导入(异步任务,单次最多 50,000 个联系人)、联系人列表、自定义字段、自定义事件(用于自动化)、导出联系人。典型速率限制为每账户每 60 秒 200 次请求,大批量建议使用导入接口。分段是动态分组,列表是显式联系人集合。
使用方式:所有端点需 Authorization: Bearer $MAILTRAP_API_TOKEN,并在路径中包含 $MAILTRAP_ACCOUNT_ID(可通过 GET https://mailtrap.io/api/accounts 获取),令牌应存于环境变量或密钥管理器。生成请求体前应先查阅当前 Contacts OpenAPI 规范,确认字段名、必填参数和嵌套结构。示例:curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts" -H "Authorization: Bearer $MAILTRAP_API_TOKEN" -H 'Content-Type: application/json';批量导入使用 /contacts/imports 并轮询导入状态;自定义事件使用 /contacts/{contact_identifier}/events。无代码方式可通过 Zapier、Make.com、n8n 等第三方工具。
适用场景:程序化联系人管理、与 CRM 或数据仓库同步、清理联系人与 CSV 导入、用自定义字段更新联系人或触发自动化事件、构建受众分段。
限制:联系人 API 结构可能变化,每次生成请求体前应核对最新 OpenAPI 规范。发送侧的硬退信、垃圾邮件投诉、退订属于 Suppressions,与营销过滤(分段、列表成员、同意标记)分开应用。具体价格、平台覆盖范围等资料暂未提供。