Gmail
Connect to your users' Gmail accounts
You'll need the following information to set up your Google App with Paragon Connect:
- Client ID
- Client Secret
- Scopes Requested
Note: You'll need to create a new project in Google Cloud Console if you don't already have one.
Paragon provides a redirect URL to send information to your Google app. To add the redirect URL to your Google app:
1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:
https://passport.useparagon.com/oauth
2. In your Google Cloud Console dashboard, navigate to APIs & Services > Credentials in the sidebar.
3. Press "+ Create Credentials", then select OAuth client ID.
4. Select "Web application" from the Application type drop-down menu.
Note: You'll need to configure Google's consent screen for access to Client ID and Client Secret if you haven't already.

5. Under Authorized redirect URIs, press the "+ Add URI" button.
6. Paste-in the redirect URL from Paragon.
7. Press the blue "Create" button.

Google provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.
2. Search for "Gmail" from the API Library.
3. Select the "Gmail API".
4. Press the blue "Enable" button to enable the API for your application.

1. Select Google Campaign Manager 360 from the Integrations Catalog.
2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:
- Client ID: Found at the end of Step 1.
- Client Secret: Found at the end of Step 1.
- Permissions: Select the scopes you've requested for your application. They should begin with
sheets
.
Press the blue "Connect" button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

Once your users have connected their Gmail account, you can use the Paragon SDK to access the Gmail API on behalf of connected users.
Any Gmail API endpoints can be accessed with the Paragon SDK as shown in this example.
// You can find your project ID in the Overview tab of any Integration
// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
// Send an email on behalf of a specified user
paragon.request("gmail", "/upload/gmail/v1/users/{userId}/messages/send", {
method: "POST",
body: {
"raw": <Base64-encoded email>
}
});
// Get all emails associated with a specified user
paragon.request("gmail", "gmail/v1/users/{userId}/messages", {
method: "GET"
});
Once your Gmail account is connected, you can add steps to perform the following actions:
- Send Email
- Get Email by ID
- Search for Email
- Delete Email
- Create a Contact
- Get Contact by Resource Name
- Search for Contact
- Delete Contact
When creating or getting ads in Gmail, you can reference data from previous steps by typing
{{
to invoke the variable menu.Webhook triggers can be used to run workflows based on events in your users' Gmail account. For example, you might want to trigger a workflow whenever new threads are created in Gmail to sync your users' Gmail threads to your application in real-time.

You can find the full list of Webhook Triggers for Gmail below:
- New Thread Created
- Thread Updated
- Thread Modified
Last modified 4mo ago