---
title: "Creates a new Gmail DRAFT for a campaign that will be sent later."
method: POST
path: "/api/campaigndrafts"
tags: ["CampaignDrafts"]
---

# Creates a new Gmail DRAFT for a campaign that will be sent later.

`POST /api/campaigndrafts`

## Request

- Base URL: `https://api.gmass.co`
- URL: `https://api.gmass.co/api/campaigndrafts`
- Auth: none declared

This will create a DRAFT in your Gmail account and return the actual Gmail DRAFT Id. Then use /campaigns to send the campaign. DO NOT specify a value for campaignDraftId.

## Request body

- CampaignDraft
  - `campaignDraftId` string: This is the DRAFT ID that will be returned. Do not specify it.
  - `fromEmail` string: The from address for the campaign. Must match an authenticated From Address in the Gmail account.
  - `subject` string, required
  - `message` string, required
  - `messageType` string: Set to either "html" or "plain". HTML messages will always result in a plain text message being auto generated by Google and sent along with the HTML MIME part.
  - `listAddress` string: The list address for this campaign. Example: aaa-bbb-ccc@gmass.co
  - `emailAddresses` string
  - `cc` string: One or more Cc addresses, separated by a comma or any other standard delimiter. Cc addresses will receive a copy of each individual email sent as part of the campaign.
  - `bcc` string: One or more Bcc addresses, separated by a comma or any other standard delimiter. Bcc addresses will receive a blind copy of each individual email sent as part of the campaign.
  - `attachments` CampaignDraftAttachment[]: The list of attachments for this message
    - `fileName` string: The filename for this attachment e.g. "Proposal.pdf"
    - `base64Content` string: The base64 string representation for the bytes of this attachment. Must be a valid base64 string
    - `contentType` string: The content type for this attachment e.g. "application/pdf"

## Response `200`

OK

- CampaignDraft
  - `campaignDraftId` string: This is the DRAFT ID that will be returned. Do not specify it.
  - `fromEmail` string: The from address for the campaign. Must match an authenticated From Address in the Gmail account.
  - `subject` string, required
  - `message` string, required
  - `messageType` string: Set to either "html" or "plain". HTML messages will always result in a plain text message being auto generated by Google and sent along with the HTML MIME part.
  - `listAddress` string: The list address for this campaign. Example: aaa-bbb-ccc@gmass.co
  - `emailAddresses` string
  - `cc` string: One or more Cc addresses, separated by a comma or any other standard delimiter. Cc addresses will receive a copy of each individual email sent as part of the campaign.
  - `bcc` string: One or more Bcc addresses, separated by a comma or any other standard delimiter. Bcc addresses will receive a blind copy of each individual email sent as part of the campaign.
  - `attachments` CampaignDraftAttachment[]: The list of attachments for this message
    - `fileName` string: The filename for this attachment e.g. "Proposal.pdf"
    - `base64Content` string: The base64 string representation for the bytes of this attachment. Must be a valid base64 string
    - `contentType` string: The content type for this attachment e.g. "application/pdf"

---

[API](https://skmtc.dev/gmass/apis/gmass-api.md) - [All operations](https://skmtc.dev/gmass/apis/gmass-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gmass/apis/gmass-api/revisions/0498e4a9c765?raw)