API

Every gmail.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.

New to Corsair? See API access, authentication, and error handling.

Drafts

create

drafts.create Create a new draft Risk: write

await corsair.gmail.api.drafts.create({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`draft`	`object`	No	Draft payload. message.raw must be a base64url-encoded RFC 2822 email, not plain text.

draft full type

{
  message?: {
    raw?: string,
    threadId?: string
  }
}

Output

Name	Type	Required	Description
`id`	`string`	No	—
`message`	`object`	No	—

message full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}

delete

drafts.delete Delete a draft [DESTRUCTIVE] Risk: destructive

await corsair.gmail.api.drafts.delete({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output: void

get

drafts.get Get a specific draft Risk: read

await corsair.gmail.api.drafts.get({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`format`	`minimal \| full \| raw \| metadata`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`message`	`object`	No	—

message full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}

list

drafts.list List drafts in the mailbox Risk: read

await corsair.gmail.api.drafts.list({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`maxResults`	`number`	No	—
`pageToken`	`string`	No	—
`q`	`string`	No	—

Output

Name	Type	Required	Description
`drafts`	`object[]`	No	—
`nextPageToken`	`string`	No	—
`resultSizeEstimate`	`number`	No	—

drafts full type

{
  id?: string,
  message?: {
    id?: string,
    threadId?: string,
    labelIds?: string[],
    snippet?: string,
    historyId?: string,
    internalDate?: string | number | Date | null,
    sizeEstimate?: number,
    payload?: {
      partId?: string,
      mimeType?: string,
      filename?: string,
      headers?: {
        name?: string,
        value?: string
      }[],
      body?: {
        attachmentId?: string,
        size?: number,
        data?: string
      },
      parts: lazy
    },
    raw?: string
  }
}[]

send

drafts.send Send a draft as an email Risk: write

await corsair.gmail.api.drafts.send({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	No	—
`message`	`object`	No	Optional message body when sending without a draft id. raw must be base64url-encoded RFC 2822, not plain text.

message full type

{
  raw?: string,
  threadId?: string
}

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

update

drafts.update Update an existing draft Risk: write

await corsair.gmail.api.drafts.update({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`draft`	`object`	No	Updated draft payload. message.raw must be a base64url-encoded RFC 2822 email, not plain text.

draft full type

{
  message?: {
    raw?: string,
    threadId?: string
  }
}

Output

Name	Type	Required	Description
`id`	`string`	No	—
`message`	`object`	No	—

message full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}

Labels

create

labels.create Create a new label Risk: write

await corsair.gmail.api.labels.create({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`label`	`object`	Yes	—

label full type

{
  name?: string,
  messageListVisibility?: show | hide,
  labelListVisibility?: labelShow | labelShowIfUnread | labelHide,
  color?: {
    textColor?: string,
    backgroundColor?: string
  }
}

Output

Name	Type	Required	Description
`id`	`string`	No	—
`name`	`string`	No	—
`messageListVisibility`	`show \| hide`	No	—
`labelListVisibility`	`labelShow \| labelShowIfUnread \| labelHide`	No	—
`type`	`system \| user`	No	—
`messagesTotal`	`number`	No	—
`messagesUnread`	`number`	No	—
`threadsTotal`	`number`	No	—
`threadsUnread`	`number`	No	—
`color`	`object`	No	—

color full type

{
  textColor?: string,
  backgroundColor?: string
}

delete

labels.delete Delete a label [DESTRUCTIVE] Risk: destructive

await corsair.gmail.api.labels.delete({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output: void

get

labels.get Get a specific label Risk: read

await corsair.gmail.api.labels.get({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`name`	`string`	No	—
`messageListVisibility`	`show \| hide`	No	—
`labelListVisibility`	`labelShow \| labelShowIfUnread \| labelHide`	No	—
`type`	`system \| user`	No	—
`messagesTotal`	`number`	No	—
`messagesUnread`	`number`	No	—
`threadsTotal`	`number`	No	—
`threadsUnread`	`number`	No	—
`color`	`object`	No	—

color full type

{
  textColor?: string,
  backgroundColor?: string
}

list

labels.list List all labels in the mailbox Risk: read

await corsair.gmail.api.labels.list({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—

Output

Name	Type	Required	Description
`labels`	`object[]`	No	—

labels full type

{
  id?: string,
  name?: string,
  messageListVisibility?: show | hide,
  labelListVisibility?: labelShow | labelShowIfUnread | labelHide,
  type?: system | user,
  messagesTotal?: number,
  messagesUnread?: number,
  threadsTotal?: number,
  threadsUnread?: number,
  color?: {
    textColor?: string,
    backgroundColor?: string
  }
}[]

update

labels.update Update an existing label Risk: write

await corsair.gmail.api.labels.update({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`label`	`object`	Yes	—

label full type

{
  name?: string,
  messageListVisibility?: show | hide,
  labelListVisibility?: labelShow | labelShowIfUnread | labelHide,
  color?: {
    textColor?: string,
    backgroundColor?: string
  }
}

Output

Name	Type	Required	Description
`id`	`string`	No	—
`name`	`string`	No	—
`messageListVisibility`	`show \| hide`	No	—
`labelListVisibility`	`labelShow \| labelShowIfUnread \| labelHide`	No	—
`type`	`system \| user`	No	—
`messagesTotal`	`number`	No	—
`messagesUnread`	`number`	No	—
`threadsTotal`	`number`	No	—
`threadsUnread`	`number`	No	—
`color`	`object`	No	—

color full type

{
  textColor?: string,
  backgroundColor?: string
}

Messages

batchModify

messages.batchModify Add or remove labels from multiple messages in bulk Risk: write

await corsair.gmail.api.messages.batchModify({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`ids`	`string[]`	No	—
`addLabelIds`	`string[]`	No	—
`removeLabelIds`	`string[]`	No	—

Output: void

delete

messages.delete Permanently delete a message [DESTRUCTIVE · IRREVERSIBLE] Risk: destructive · Irreversible

await corsair.gmail.api.messages.delete({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output: void

get

messages.get Get a specific message Risk: read

await corsair.gmail.api.messages.get({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`format`	`minimal \| full \| raw \| metadata`	No	—
`metadataHeaders`	`string[]`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

list

messages.list List messages in a mailbox Risk: read

await corsair.gmail.api.messages.list({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`q`	`string`	No	—
`maxResults`	`number`	No	—
`pageToken`	`string`	No	—
`labelIds`	`string[]`	No	—
`includeSpamTrash`	`boolean`	No	—

Output

Name	Type	Required	Description
`messages`	`object[]`	No	—
`nextPageToken`	`string`	No	—
`resultSizeEstimate`	`number`	No	—

messages full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}[]

modify

messages.modify Add or remove labels from a message Risk: write

await corsair.gmail.api.messages.modify({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`addLabelIds`	`string[]`	No	—
`removeLabelIds`	`string[]`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

send

messages.send Send an email to one or more recipients Risk: write

await corsair.gmail.api.messages.send({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`raw`	`string`	Yes	Base64url-encoded RFC 2822 email — do NOT pass plain email text. Build the MIME message (From, To, Subject, Content-Type headers, blank line, body; lines separated by \r\n), then base64url-encode: standard base64, replace + with -, / with _, remove trailing =.
`threadId`	`string`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

trash

messages.trash Move a message to the trash Risk: write

await corsair.gmail.api.messages.trash({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

untrash

messages.untrash Restore a message from the trash Risk: write

await corsair.gmail.api.messages.untrash({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`threadId`	`string`	No	—
`labelIds`	`string[]`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`internalDate`	`string \| number \| Date`	No	—
`sizeEstimate`	`number`	No	—
`payload`	`object`	No	—
`raw`	`string`	No	Full RFC 2822 message in base64url encoding (when format=raw). Not plain text — decode base64url before reading headers/body.

payload full type

{
  partId?: string,
  mimeType?: string,
  filename?: string,
  headers?: {
    name?: string,
    value?: string
  }[],
  body?: {
    attachmentId?: string,
    size?: number,
    data?: string
  },
  parts: lazy
}

Threads

delete

threads.delete Permanently delete a thread [DESTRUCTIVE · IRREVERSIBLE] Risk: destructive · Irreversible

await corsair.gmail.api.threads.delete({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output: void

get

threads.get Get a specific thread Risk: read

await corsair.gmail.api.threads.get({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`format`	`minimal \| full \| metadata`	No	—
`metadataHeaders`	`string[]`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`messages`	`object[]`	No	—

messages full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}[]

list

threads.list List threads in the mailbox Risk: read

await corsair.gmail.api.threads.list({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`q`	`string`	No	—
`maxResults`	`number`	No	—
`pageToken`	`string`	No	—
`labelIds`	`string[]`	No	—
`includeSpamTrash`	`boolean`	No	—

Output

Name	Type	Required	Description
`threads`	`object[]`	No	—
`nextPageToken`	`string`	No	—
`resultSizeEstimate`	`number`	No	—

threads full type

{
  id?: string,
  snippet?: string,
  historyId?: string,
  messages?: {
    id?: string,
    threadId?: string,
    labelIds?: string[],
    snippet?: string,
    historyId?: string,
    internalDate?: string | number | Date | null,
    sizeEstimate?: number,
    payload?: {
      partId?: string,
      mimeType?: string,
      filename?: string,
      headers?: {
        name?: string,
        value?: string
      }[],
      body?: {
        attachmentId?: string,
        size?: number,
        data?: string
      },
      parts: lazy
    },
    raw?: string
  }[]
}[]

modify

threads.modify Add or remove labels from a thread Risk: write

await corsair.gmail.api.threads.modify({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—
`addLabelIds`	`string[]`	No	—
`removeLabelIds`	`string[]`	No	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`messages`	`object[]`	No	—

messages full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}[]

trash

threads.trash Move a thread to the trash Risk: write

await corsair.gmail.api.threads.trash({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`messages`	`object[]`	No	—

messages full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}[]

untrash

threads.untrash Restore a thread from the trash Risk: write

await corsair.gmail.api.threads.untrash({});

Input

Name	Type	Required	Description
`userId`	`string`	No	—
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`id`	`string`	No	—
`snippet`	`string`	No	—
`historyId`	`string`	No	—
`messages`	`object[]`	No	—

messages full type

{
  id?: string,
  threadId?: string,
  labelIds?: string[],
  snippet?: string,
  historyId?: string,
  internalDate?: string | number | Date | null,
  sizeEstimate?: number,
  payload?: {
    partId?: string,
    mimeType?: string,
    filename?: string,
    headers?: {
      name?: string,
      value?: string
    }[],
    body?: {
      attachmentId?: string,
      size?: number,
      data?: string
    },
    parts: lazy
  },
  raw?: string
}[]

Overview

Plugins

Drafts

create

delete

get

list

send

update

Labels

create

delete

get

list

update

Messages

batchModify

delete

get

list

modify

send

trash

untrash

Threads

delete

get

list

modify

trash

untrash

​Drafts

​create

​delete

​get

​list

​send

​update

​Labels

​create

​delete

​get

​list

​update

​Messages

​batchModify

​delete

​get

​list

​modify

​send

​trash

​untrash

​Threads

​delete

​get

​list

​modify

​trash

​untrash

Drafts

create

delete

get

list

send

update

Labels

create

delete

get

list

update

Messages

batchModify

delete

get

list

modify

send

trash

untrash

Threads

delete

get

list

modify

trash

untrash