Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Create a Gmail label with optional visibility and color.
gmail.createLabel creates a user-owned label and returns its metadata.
import { automation } from "automate.ax"
import { gmail } from "automate.ax/gmail"
export default automation("Create a Gmail follow-up label", () => {
gmail.createLabel({
color: {
backgroundColor: "#0b804b",
textColor: "#ffffff",
},
name: "Automate.ax/Follow up",
labelListVisibility: "labelShow",
messageListVisibility: "show",
})
})
| Property | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable label name. Nested names can use Gmail’s / convention. |
labelListVisibility | "labelHide" | "labelShow" | "labelShowIfUnread" | No | Visibility in Gmail’s label list. |
messageListVisibility | "hide" | "show" | No | Visibility beside messages in Gmail’s message list. |
color | { backgroundColor: Gmail label color; textColor: Gmail label color } | No | Hex colors from Gmail’s supported label-color palette. |
Second argument: { account } | string | IntegrationAccountReference<"google"> | No | Google Account binding. Defaults to the project binding. |
Signal<GmailLabel>:
interface GmailLabel {
labelId: string
name: string
type?: "system" | "user"
labelListVisibility?: "labelHide" | "labelShow" | "labelShowIfUnread"
messageListVisibility?: "hide" | "show"
color?: {
backgroundColor: string
textColor: string
}
messagesTotal?: number
messagesUnread?: number
threadsTotal?: number
threadsUnread?: number
}
labelId when later actions need an immutable identifier. A label’s display name can change.