使用 ServiceM8 REST API 发送邮件时返回 200 OK 且收件人正常接收，但邮件未出现在目标工单（Job）的日记中——根本原因在于参数命名错误：job_uuid 无效，必须改用 regardingJobUUID 字段并确保其值为合法 UUID 格式。
使用 servicem8 rest api 发送邮件时返回 200 ok 且收件人正常接收，但邮件未出现在目标工单（job）的日记中——根本原因在于参数命名错误：`job_uuid` 无效，必须改用 `regardingjobuuid` 字段并确保其值为合法 uuid 格式。
在 ServiceM8 平台中，通过 /platform_service_email 端点发送的外发邮件若需自动归档至特定工单的「日记（Job Diary）」，必须显式声明该邮件与工单的上下文关联关系。官方 API 文档已明确要求使用字段 regardingJobUUID（而非 job_uuid、job_id 或其他变体），且该字段为可选但关联必需项——仅当提供有效值时，系统才会将邮件条目写入对应工单的日记流。
✅ 正确请求示例（关键修正部分已高亮）：
{
"to": "client@example.com",
"from": "admin@company.com",
"subject": "It works",
"message": "This message confirms Email was sent correctly",
"htmlBody": "<p>This message confirms Email was sent correctly</p>",
"textBody": "This message confirms Email was sent correctly",
"regardingJobUUID": "7c950fdd-7cbf-4b87-ad9b-2294227485db"
}
⚠️ 注意事项：
-
regardingJobUUID值必须为 完整、带连字符的 UUID 字符串（如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx），大小写不敏感，但格式错误（如缺失连字符、长度不符、含非法字符）将导致关联静默失败； - 该字段不可与
template_uuid混用替代：模板仅控制内容渲染，不承载上下文绑定逻辑； - 身份认证方式（Basic Auth 用户名/密码）本身不影响日记关联，只要认证通过即可调用 API；但建议生产环境迁移到 OAuth 2.0 访问令牌以符合安全最佳实践；
- 若仍不显示，请检查目标工单状态：已归档（Archived）或已删除（Deleted）的工单不接受新日记条目，API 不会报错但会忽略
regardingJobUUID。
? 验证步骤建议：
- 使用
GET /job/{uuid}接口确认工单存在且status为active； - 在请求中临时移除
template_uuid，排除模板逻辑干扰； - 使用
curl -v或 Postman 查看响应头中的X-ServiceM8-Request-ID，便于向 ServiceM8 支持团队提交精准排查日志。
简言之：不是“邮件没发出去”，而是“邮件没说清楚它属于谁”。只需将 job_uuid 替换为语义准确、文档合规的 regardingJobUUID，即可让每封 API 邮件精准落位至业务工单日记，实现流程闭环与审计可追溯。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
