用途：管理 Mailtrap 营销联系人数据库，包括联系人、列表、细分、自定义字段和批量导入，用于构建营销活动受众及相关工作流。生成请求体前应先查看 Contacts OpenAPI 规范，确认当前字段名、必填参数和嵌套结构。
主要能力：通过 API 创建、获取、更新、删除联系人；异步批量导入；管理联系人列表、自定义字段、自定义事件和导出联系人。联系人 API 可自动化创建/更新，并可用于 CRM 或 CDP 同步（由你的代码或 Zapier、Make、n8n 等工具实现）。
使用方式：所有端点需要 Authorization: Bearer $MAILTRAP_API_TOKEN，并在路径中包含 $MAILTRAP_ACCOUNT_ID。主要端点包括 https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts、/contacts/imports、/contacts/lists、/contacts/fields、/contacts/{contact_identifier}/events、/contacts/exports。批量导入为异步任务，可用 GET .../contacts/imports/{import_id} 轮询状态。
限制：典型速率限制为每账户每 60 秒 200 次请求，大批量应优先使用批量导入；单次导入最多 50,000 个联系人。营销联系人过滤（细分、列表成员、同意标志）与发送侧抑制（硬退信、垃圾邮件投诉、退订）是分开的，发送侧阻止需参考 Suppressions 和 sending-emails 技能。相关技能包括 authorizing-api-requests 和 sending-emails。