---
title: 创建草稿并发送邮件
description: 创建邮件草稿，取得草稿 ID 后发送邮件。
sidebar_label: 创建草稿并发送邮件
sidebar_position: 2
---

# 创建草稿并发送邮件

企业邮箱 API 发信需要两个步骤：先创建草稿并保存返回的邮件 ID，再发送该草稿。批量通知或营销邮件应使用邮件推送产品。

## 调用顺序

1. 调用[创建邮件草稿](/api/alimailpb-alimail-mailagent-open-mail-service-create-message)。
2. 从响应的 `message.id` 读取草稿 ID。
3. 调用[发送邮件草稿](/api/alimailpb-alimail-mailagent-open-mail-service-send-message)。
4. 保存请求 ID 和业务结果，便于审计与排查。

## Python 示例

```python runtimeApiEndpoint
import requests

API_BASE = "https://alimail-cn.aliyuncs.com"


def send_mail(access_token: str, mailbox: str, message: dict) -> None:
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json",
    }
    draft = requests.post(
        f"{API_BASE}/v2/users/{mailbox}/messages",
        headers=headers,
        json={"message": message},
        timeout=15,
    )
    draft.raise_for_status()
    draft_id = draft.json()["message"]["id"]

    sent = requests.post(
        f"{API_BASE}/v2/users/{mailbox}/messages/{draft_id}/send",
        headers=headers,
        json={"saveToSentItems": True},
        timeout=15,
    )
    sent.raise_for_status()
```

生产代码还应校验收件人、限制单次发送范围，并为重复请求增加幂等控制。发送是真实外部动作，联调时优先使用测试邮箱。

参考：[原始示例](https://help.aliyun.com/zh/document_detail/2856076.html)。