---
title: 'Gmail'
description: 'Send, read, and manage emails, threads, labels, and drafts via the Gmail REST API using OAuth2.'
---

# Gmail

Send, read, and manage emails, threads, labels, and drafts via the Gmail REST API using OAuth2.

| Detail | Value |
|---|---|
| Category | Communication |
| Base URL | `https://gmail.googleapis.com` |
| Authentication | OAuth2 Authorization Code |
| Endpoints | 17 |
| Connector key | `gmail` |

## Using Gmail in a workflow

1. Go to **Connections** and click **New Connection**.
2. Pick **Gmail** from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an **API Call** node and select this connection.
5. Pick the operation you need from the Operation dropdown — see the table below.

## Available Endpoints

| Endpoint | Summary |
|---|---|
| [GET /gmail/v1/users/{userId}/profile](./get_gmail_v1_users_userid_profile_getprofile) | Get the current user's Gmail profile |
| [GET /gmail/v1/users/{userId}/messages](./get_gmail_v1_users_userid_messages_listmessages) | List messages in the mailbox |
| [POST /gmail/v1/users/{userId}/messages](./post_gmail_v1_users_userid_messages_sendmessage) | Send a message |
| [GET /gmail/v1/users/{userId}/messages/{id}](./get_gmail_v1_users_userid_messages_id_getmessage) | Get a specific message by ID |
| [DELETE /gmail/v1/users/{userId}/messages/{id}](./delete_gmail_v1_users_userid_messages_id_deletemessage) | Permanently delete a message |
| [POST /gmail/v1/users/{userId}/messages/{id}/modify](./post_gmail_v1_users_userid_messages_id_modify_modifymessage) | Modify labels applied to a message |
| [GET /gmail/v1/users/{userId}/threads](./get_gmail_v1_users_userid_threads_listthreads) | List threads in the mailbox |
| [GET /gmail/v1/users/{userId}/threads/{id}](./get_gmail_v1_users_userid_threads_id_getthread) | Get a specific thread by ID |
| [DELETE /gmail/v1/users/{userId}/threads/{id}](./delete_gmail_v1_users_userid_threads_id_deletethread) | Permanently delete a thread |
| [GET /gmail/v1/users/{userId}/labels](./get_gmail_v1_users_userid_labels_listlabels) | List all labels in the mailbox |
| [POST /gmail/v1/users/{userId}/labels](./post_gmail_v1_users_userid_labels_createlabel) | Create a new label |
| [PUT /gmail/v1/users/{userId}/labels/{id}](./put_gmail_v1_users_userid_labels_id_updatelabel) | Update a label |
| [DELETE /gmail/v1/users/{userId}/labels/{id}](./delete_gmail_v1_users_userid_labels_id_deletelabel) | Delete a label |
| [GET /gmail/v1/users/{userId}/drafts](./get_gmail_v1_users_userid_drafts_listdrafts) | List drafts in the mailbox |
| [POST /gmail/v1/users/{userId}/drafts](./post_gmail_v1_users_userid_drafts_createdraft) | Create a new draft |
| [POST /gmail/v1/users/{userId}/drafts/send](./post_gmail_v1_users_userid_drafts_send_senddraft) | Send an existing draft |
| [DELETE /gmail/v1/users/{userId}/drafts/{id}](./delete_gmail_v1_users_userid_drafts_id_deletedraft) | Delete a draft |

> Each endpoint has its own page with parameter details, an example
> `API Call` node configuration, and the response shape.