Gmail (Developer App)
Private and secure email by Google at no cost, for business and consumer accounts. Use this app to connect your own developer account credentials.
Go to siteGmail (Developer App) API Integrations
Build and run workflows using the Gmail (Developer App) API. Use 1000s of source-available triggers and actions across 1000+ apps. Or write custom code to integrate any app or API in seconds.
Overview#
By connecting your personal Gmail account to Pipedream, you'll be able to incorporate email into whatever you're building with any of the 900+ apps that are available on Pipedream.
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
gmail_custom_oauth: {
type: "app",
app: "gmail_custom_oauth",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://www.googleapis.com/oauth2/v1/userinfo`,
headers: {
Authorization: `Bearer ${this.gmail_custom_oauth.$auth.oauth_access_token}`,
},
})
},
})
Choose an API to Connect with Gmail (Developer App) API#
1-12of1000+apps by most popular
Getting Started#
The Google Developer App in Pipedream can integrate with either a personal Gmail account or a Google workspace email account. Either option involves creating a custom Google App in the Google Cloud Console. This process does not involve any code or special approval by Google. The steps are outlined below:
Creating a Gmail app
In order to connect your personal or workspace Gmail account to Pipedream, you'll need to create a custom OAuth app in Google Cloud.
- Sign in to the Google Cloud Console
- Select an existing project or create a new one
- Select APIs & Services
- Click Enable APIs & Services
- Search for and select Gmail API
- Click Enable
- Click OAuth consent screen on the left side
- Select External User Type and click “Create”
- Fill in the required fields and click Save and Continue
- Click Add or remove scopes and select the
https://mail.google.com/scope and then click "Update" - Click Save and Continue to finish the Scopes step
- Add your own email as a Test User by clicking *Add Users& then typing in your email in the prompt then clicking Add again. Then finally click Save and Continue to finish the Test Users portion.
- You should be prompted with a Summary page.
Now you've created an unlisted Gmail App that you can integrate with Pipedream.
Create OAuth Credentials
You will need to generate a set of OAuth credentials to connect your new Gmail app to Pipedream properly.
Navigate to the Credentials section on the left side.
Click Create Credentials at the top and select “*OAuth client ID
- Select Web application for Application type
- Name the app “Pipedream”
- Click Add URI and enter
https://api.pipedream.com/connect/oauth/oa_G7Ain6/callback
- Click Create to create your new OAuth keys
- Note the client ID and client Secret, but keep these private and secure
Connect your Gmail app Pipedream with your Gmail app OAuth crendentials
At this point, you should have a Gmail App under your Google Project, and a set of OAuth keys.
Now when prompted in Pipedream after trying to connect a Gmail Developer App, copy and paste your OAuth credentials.
Also select the scopes you chose when defining the app. We recommend using
https://mail.google.com/Then click Connect
If you did not publish your Gmail App in the Google Cloud Console, just click Continue to ignore the warning.
Check all of the necessary scopes you'll need for your workflows
Click the final Connect and your custom Gmail app should be integrated into Pipedream!
Popular Gmail (Developer App) Integrations#
Popular Gmail (Developer App) Triggers#
Emit new event for each attachment in a message received. This source is capped at 100 max new messages per run.
Emit new event when an email is received. This source is capped at 100 max new messages per run.
Emit new event for each new email sent. (Maximum of 300 events emited per execution)
Popular Gmail (Developer App) Actions#
Create a draft from your Google Workspace email account
Find an email using Google's Search Engine. See the docs
Update the signature for a specific email address in an organization. A Google Cloud service account with delegated domain-wide authority is required for this action. See docs here
Authentication#
Gmail (Developer App) uses OAuth authentication. When you connect your Gmail (Developer App) account, Pipedream will open a popup window where you can sign into Gmail (Developer App) and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Gmail (Developer App) API.
Pipedream requests the following authorization scopes when you connect your account:
do not use- authorization
GEThttps://accounts.google.com/o/oauth2/auth?client_id={{custom_fields.client_id}}&state={{oauth.state}}&redirect_uri={{oauth.redirect_uri}}&response_type=code&scope=email profile {{custom_fields.space_separated_scopes}}&access_type=offline&prompt=consent - accessToken
POSThttps://oauth2.googleapis.com/tokencontent-type:application/x-www-form-urlencodedaccept:application/jsonclient_id={{custom_fields.client_id}}&client_secret={{custom_fields.client_secret}}&grant_type=authorization_code&code={{oauth.code}}&redirect_uri={{oauth.redirect_uri}} - refreshToken
POSThttps://oauth2.googleapis.com/tokencontent-type:application/x-www-form-urlencodedaccept:application/jsonclient_id={{custom_fields.client_id}}&client_secret={{custom_fields.client_secret}}&grant_type=refresh_token&refresh_token={{oauth.refresh_token}}