Gmail integration

Fetch emails

Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.

Fetch message by message id

Fetches a specific email message by its id, provided the `message id` exists and is accessible to the authenticated `user id`.

Fetch message by thread id

Retrieves messages from a gmail thread using its `thread id`, where the thread must be accessible by the specified `user id`.

Get attachment

Retrieves a specific attachment by id from a message in a user's gmail mailbox, requiring valid message and attachment ids.

Get contacts

Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination.

Get people

Retrieves either a specific person's details (using `resource name`) or lists 'other contacts' (if `other contacts` is true), with `person fields` specifying the data to return.

Get profile

Retrieves key gmail profile information (email address, message/thread totals, history id) for a user.

List drafts

Retrieves a paginated list of email drafts from a user's gmail account. use verbose=true to get full draft details including subject, body, sender, and timestamp.

List labels

Retrieves a list of all system and user-created labels for the specified gmail account.

List threads

Retrieves a list of email threads from a gmail account, identified by `user id` (email address or 'me'), supporting filtering and pagination.

Search people

Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'other contacts'.

Add label to email

Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids).

Create email draft

Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading.

Create label

Creates a new label with a unique name in the specified user's gmail account.

Delete draft

Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`.

Delete message

Permanently deletes a specific email message by its id from a gmail mailbox; for `user id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.

Modify thread labels

Adds or removes specified existing label ids from a gmail thread, affecting all its messages; ensure the thread id is valid.

Move to trash

Moves an existing, non-deleted email message to the trash for the specified user.

Patch label

Patches the specified label.

Remove label

Permanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels.

Reply to thread

Sends a reply within a specific gmail thread using the original thread's subject, requiring a valid `thread id` and correctly formatted email addresses. supports attachments via the `attachment` parameter with valid `s3key`, `mimetype`, and `name`.

Send draft

Sends the specified, existing draft to the recipients in the to, cc, and bcc headers.

Send email

Sends an email via gmail api using the authenticated user's google profile display name, requiring `is html=true` if the body contains html and valid `s3key`, `mimetype`, `name` for any attachment.