Skip to content

Gmail ​

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

DetailValue
CategoryCommunication
Base URLhttps://gmail.googleapis.com
AuthenticationOAuth2 Authorization Code
Endpoints17
Connector keygmail

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 ​

EndpointSummary
GET /gmail/v1/users/{userId}/profileGet the current user's Gmail profile
GET /gmail/v1/users/{userId}/messagesList messages in the mailbox
POST /gmail/v1/users/{userId}/messagesSend a message
GET /gmail/v1/users/{userId}/messages/{id}Get a specific message by ID
DELETE /gmail/v1/users/{userId}/messages/{id}Permanently delete a message
POST /gmail/v1/users/{userId}/messages/{id}/modifyModify labels applied to a message
GET /gmail/v1/users/{userId}/threadsList threads in the mailbox
GET /gmail/v1/users/{userId}/threads/{id}Get a specific thread by ID
DELETE /gmail/v1/users/{userId}/threads/{id}Permanently delete a thread
GET /gmail/v1/users/{userId}/labelsList all labels in the mailbox
POST /gmail/v1/users/{userId}/labelsCreate a new label
PUT /gmail/v1/users/{userId}/labels/{id}Update a label
DELETE /gmail/v1/users/{userId}/labels/{id}Delete a label
GET /gmail/v1/users/{userId}/draftsList drafts in the mailbox
POST /gmail/v1/users/{userId}/draftsCreate a new draft
POST /gmail/v1/users/{userId}/drafts/sendSend an existing draft
DELETE /gmail/v1/users/{userId}/drafts/{id}Delete a draft

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