Action: Create Label

Gmail Operation

The Create Label action generates a new custom label in Gmail for organizing emails.

Example User Story

I want to create a 'Vendor Invoices' label to automatically categorize financial emails.

Fields

Field Name	Field Type	Required
name	String	Yes
labelListVisibility	String	No
messageListVisibility	String	No
id	String	No
accessToken	String	Yes

Related Connections

Gmail

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-label",
  "state": "inDev",
  "meta": {
    "short": "Create Label",
    "description": "Creates a new label in Gmail."
  },
  "input": [
    {
      "name": "name",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Name of the label to create."
      }
    },
    {
      "name": "labelListVisibility",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Label visibility in the label list.",
        "options": ["labelShow", "labelHide"]
      }
    },
    {
      "name": "messageListVisibility",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Label visibility in the message list.",
        "options": ["show", "hide"]
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the created label."
      }
    },
    {
      "name": "name",
      "type": "String",
      "selector": ["name"],
      "meta": {
        "description": "The name of the created label."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/gmail/v1/users/me/labels",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"name\": \"{{name}}\", \"labelListVisibility\": \"{{labelListVisibility}}\", \"messageListVisibility\": \"{{messageListVisibility}}\"}",
          "placeholders": [
            {
              "name": "name",
              "type": "String",
              "description": "Name of the label to create.",
              "required": true
            },
            {
              "name": "labelListVisibility",
              "type": "String",
              "description": "Label visibility in the label list.",
              "required": false,
              "options": ["labelShow", "labelHide"]
            },
            {
              "name": "messageListVisibility",
              "type": "String",
              "description": "Label visibility in the message list.",
              "required": false,
              "options": ["show", "hide"]
            },
            {
              "name": "accessToken",
              "type": "String",
              "description": "Access token for authenticating with Gmail API.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}