Action: Add Label to Email

Gmail Operation

The Add Label to Email action applies a specified label to a selected email in Gmail for better organization.

Example User Story

I want to quickly add a 'Follow-Up' label to important emails so I can easily track and prioritize them later.

Fields

Field Name	Field Type	Required
emailId	String	Yes
labelId	String	Yes
accessToken	String	Yes

Related Connections

Gmail

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "add-label-to-email",
  "state": "inDev",
  "meta": {
    "short": "Add Label to Email",
    "description": "Adds a specified label to an email in Gmail."
  },
  "input": [
    {
      "name": "emailId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the email to which the label will be added."
      }
    },
    {
      "name": "labelId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the label to be added to the email."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": ["success"],
      "meta": {
        "description": "Indicates whether the label was successfully added to the email."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/gmail/v1/users/me/messages/{{emailId}}/modify",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"addLabelIds\": [\"{{labelId}}\"]}",
          "placeholders": [
            {
              "name": "emailId",
              "type": "String",
              "description": "The ID of the email.",
              "required": true
            },
            {
              "name": "labelId",
              "type": "String",
              "description": "The ID of the label to be added.",
              "required": true
            },
            {
              "name": "accessToken",
              "type": "String",
              "description": "The access token for authenticating with the Gmail API.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}