Action: Create Draft

Gmail Operation

The Create Draft action starts a new unsent email in Gmail with optional pre-filled content.

Example User Story

I want to create a draft for next week's newsletter so I can refine the content before sending.

Fields

Field Name	Field Type	Required
to	String	Yes
subject	String	No
body	String	No
draftId	String	No
messageId	String	No

Related Connections

Gmail

Related Automations

{
  "handle": "create-draft",
  "state": "inDev",
  "meta": {
    "short": "Create Draft",
    "description": "Creates a new draft email in Gmail."
  },
  "input": [
    {
      "name": "to",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Recipient email address"
      }
    },
    {
      "name": "subject",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Subject of the email"
      }
    },
    {
      "name": "body",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Body content of the email"
      }
    }
  ],
  "output": [
    {
      "name": "draftId",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "ID of the created draft"
      }
    },
    {
      "name": "messageId",
      "type": "String",
      "selector": ["message", "id"],
      "meta": {
        "description": "ID of the message in the draft"
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/gmail/v1/users/me/drafts",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"message\": {\"raw\": \"{{base64EncodedEmail}}\"}}",
          "placeholders": [
            {
              "name": "accessToken",
              "type": "String",
              "description": "OAuth access token for Gmail API",
              "required": true
            },
            {
              "name": "base64EncodedEmail",
              "type": "String",
              "description": "Base64 URL-safe encoded email message",
              "required": true
            }
          ]
        }
      }
    }
  ]
}

Code (Apache v2.0): Operation