Gmail
+
Konnectify
Gmail Integration with Konnectify
Connect to Google’s email service to automatically read, send, and manage emails, threads, labels, drafts, and attachments across your workflows.
Emails
Attachments
Threads
Labels
Drafts
Search
7 Triggers
14 Actions
What is Gmail?
Gmail is Google’s email service for sending, receiving, and organizing messages using labels, threads (conversations), search, and attachments. With Konnectify, you can automate email-driven workflows—route messages, apply labels, respond faster, and sync attachments to downstream systems—without manual triage.
This integration is ideal for support, sales, operations, and back-office teams that want consistent email handling (labeling, archiving, forwarding, replying, and search-based routing) at scale.
New to Gmail?
Create an account or learn about Gmail features like labels, filters, and conversation view.
Go to Gmail
What you can automate
•
Trigger workflows on new inbox emails, starred emails, or messages with attachments
•
Route messages using Gmail search queries (advanced search syntax)
•
Send, forward, and reply to emails automatically
•
Manage labels (create, add, remove) and archive/delete messages
•
Work with threads (conversations) and apply label changes across the entire conversation
•
Download and process attachments for storage, OCR, or downstream systems
API & authentication
Authentication: OAuth 2.0 authorization
Konnectify connects to Gmail using Google OAuth 2.0. During connection, you’ll sign in to your Google account and grant access; Konnectify receives tokens from Google to act on your behalf. Your Google password is never stored in Konnectify.
Permissions/scope used: This integration requests Gmail access via the Google scope
https://mail.google.com/, enabling read, send, modify, and label management operations.
API capabilities in this connector include:
- Read messages and threads, search mailbox, and fetch message details
- Send, forward, and reply to emails; create drafts
- Manage labels (create labels; add/remove labels on emails and conversations)
- Archive and delete (trash) emails
- Download attachment data for processing
Rate limits & quotas
Gmail API usage is subject to Google API quotas and per-user limits. If you see intermittent failures (HTTP 429/403 quota errors), reduce polling frequency, narrow search queries, and avoid downloading large attachments in high volume.
How to connect
Prerequisites
- A Google account with Gmail enabled
- A Google Cloud project with OAuth consent screen configured
- OAuth 2.0 Client ID and Client Secret
- Access to Konnectify to create/update workflows
Add Gmail to a Workflow
- Open your Konnectify workspace and create (or open) a Workflow.
- Click Add step and choose Gmail as the app.
Authorize via OAuth 2.0
- Select Add new connection.
- Enter your Client ID and Client Secret from Google Cloud.
- Complete the Google sign-in and consent screen to grant Gmail access.
Configure the Trigger or Action
- Choose a Gmail Trigger (to start the workflow) or an Action (to perform an operation).
- For search/label-based triggers, provide a Gmail search query or select the label to monitor.
- Map fields from previous steps (e.g., email ID, thread ID, recipient, subject, body).
Important
Be careful when using Delete Email, label automation, or broad search queries. Test with a non-critical mailbox or a narrow query first to prevent unintended modifications.
Test the Workflow
- Run a test by sending yourself a sample email (or matching your search query).
- Verify the output (message ID, headers, labels, attachments) and confirm downstream steps behave as expected.
Activate the Workflow
- Turn on the Workflow.
- Monitor the first few runs to ensure polling frequency and label/search conditions match your expectations.
Triggers
7
Gmail triggers in Konnectify are polling-based, meaning Konnectify checks Gmail at an interval for new items that match the trigger criteria.
Emails
5 triggers
New Email
Polls for new emails in the INBOX.
New Email Matching Search
Polls for new emails that match a specified Gmail search query.
New Starred Email
Polls for new emails that have the STARRED label.
New Labeled Email
Polls for new emails that have a specific user-defined label.
New Attachment
Polls for new emails that contain one or more attachments.
Threads
2 triggers
New Thread
Polls for new threads (conversations).
New Labeled Conversation
Polls for conversations that receive a specific label for the first time.
Actions
14
Use Gmail actions to send messages, manage labels, handle attachments, and organize emails/threads as part of an automated workflow.
Emails
7 actions
Forward Email
Forwards an existing email to new recipients.
Send Email
Creates and immediately sends a new email.
Reply to Email
Creates and sends a reply to a specific email.
Add Label to Email
Finds an email by its ID and adds labels to it.
Remove Label from Email
Finds an email by its ID and removes labels from it.
Delete Email
Moves a specific email to the trash.
Archive Email
Archives an email by removing the INBOX label.
Drafts
3 actions
Create Draft
Creates a new draft in your Gmail account.
Create Draft Reply
Creates a draft reply without sending it.
Reply to Email
Creates and sends a reply to a specific email.
Tip: Use Create Draft / Create Draft Reply when you want a human-in-the-loop review before sending.
Labels
1 actions
Create Label
Creates a new user-defined label in Gmail.
Attachments
1 actions
Get Attachment
Downloads the data for a specific attachment.
Threads
1 actions
Remove Label from Conversation
Removes a label from an entire thread/conversation.
Search
2 actions
Find Message by ID
Fetches a Gmail message using the Gmail message ID.
Search Email
Searches for a specific email using Gmail search syntax.
Popular automations
Auto-triage inbox emails with labels
When a new email arrives, automatically apply a label (for routing, reporting, or follow-up) and optionally archive it from the inbox.
New Email
→
Add Label to Email
→
Archive Email
Escalate starred emails by forwarding
Automatically forward newly starred emails to a shared inbox or escalation list (e.g., managers, on-call, compliance).
New Starred Email
→
Forward Email
Search-based routing and auto-reply
Route emails that match a Gmail search query (subject keywords, from domains, has:attachment, etc.) and reply with an acknowledgement or next steps.
New Email Matching Search
→
Reply to Email
→
Add Label to Email
Process attachments from incoming emails
When an email arrives with attachments, download the attachment data for storage, parsing, or downstream processing, then label the email as “Processed”.
New Attachment
→
Get Attachment
→
Add Label to Email
FAQ
How does authentication work for the Gmail integration?
Konnectify uses Google OAuth 2.0. You provide a Google OAuth Client ID/Secret, then sign in to Google and grant consent. Konnectify stores only the access/refresh tokens required to run workflows; your Google password is never stored.
Which Gmail / Google Workspace plans are supported?
The integration works with most consumer Gmail and Google Workspace accounts as long as Gmail API access is allowed. In some Workspace domains, an admin may restrict OAuth scopes or third-party app access—check Google Admin policies if authorization fails.
Are Gmail triggers polling or webhook-based?
All available Gmail triggers in this connector are polling triggers. Konnectify periodically checks Gmail for new messages/threads that match the trigger criteria (inbox, label, attachment, or search query).
How do I prevent duplicate runs for the same email?
Use the Gmail message ID (or thread ID for conversation-based triggers) as an idempotency key in your workflow. Common patterns include: storing processed IDs in a datastore, adding a “Processed” label, or archiving the message after successful handling.
What happens if Gmail rate limits are hit?
If Google returns quota/rate-limit responses (often HTTP 429 or quota-related 403), runs may fail or retry depending on your workflow settings. To reduce errors, narrow search queries, lower polling frequency, avoid repeated attachment downloads, and batch downstream processing where possible.
Can I connect multiple Gmail accounts?
Yes. Create a separate Konnectify connection for each Gmail/Workspace mailbox you want to automate. In each workflow step, choose the specific connection (account) to use.
What’s the difference between labels on an email vs. labels on a conversation?
Gmail organizes messages into threads (conversations). Labels can apply to individual messages and/or the thread depending on the API operation. Use Add/Remove Label to Email to target a specific message by ID, and use Remove Label from Conversation when you want the change applied across the whole thread.
Ready to automate your Gmail workflows?
Connect Gmail to Konnectify to route, respond, label, archive, and process emails automatically.
Get started free →
