Gmail
Read mailbox messages with the Gmail API (mail.fetch).
OCNORA ships 18 typed Gmail operations and 1 trigger. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run.
Before you connect Gmail
- Authentication
- OAuth 2.0
- Credential
- {"client_id", "client_secret", "refresh_token"}
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
What you can do with Gmail
Operations, grouped by what they do to your data, plus 1 trigger that start a run.
Create and send 3
Read and search 7
Update 2
Delete and cancel 2
Other operations 4
Nodes that use your Gmail connection
Beyond its own nodes, these generic nodes accept your Gmail credential. Each chooses the provider from the connection you select, so the same node also works with the other providers shown.
- Fetch Emailmail.fetchRead the next matching message from a Gmail, Outlook or IMAP inbox.Also works withHostinger EmailOutlook / Microsoft 365
- Send Emailmail.sendSend an email through a SendGrid, SMTP, Hostinger, COAX Email API, Outlook or Gmail connection.
A sample Gmail workflow
- 1New Emailtrigger.gmail_new_emailStart a run for each new email matching a Gmail search (polled).
- 2Get Attachmentgmail.get_attachmentDownload one attachment from a Gmail message as a base64 file blob.
- 3Add/Remove Labelsgmail.add_labelAdd or remove labels on a Gmail message (by label name or id).
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Triggers 1
Operations 18
- Add/Remove LabelsAdd or remove labels on a Gmail message (by label name or id).gmail.add_label
- Create DraftSave an email as a Gmail draft (optionally inside an existing thread).gmail.create_draft
- Create LabelCreate a Gmail label, or return the existing one with that name.gmail.create_label
- Create MessageDirectly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification.gmail.create_message
- Delete DraftImmediately and permanently deletes the specified draft.gmail.delete_draft
- Delete LabelImmediately and permanently deletes the specified label and removes it from any messages and threads that it's applied to.gmail.delete_label
- Get AttachmentDownload one attachment from a Gmail message as a base64 file blob.gmail.get_attachment
- Get DraftGets the specified draft.gmail.get_draft
- Get LabelGets the specified label.gmail.get_label
- Get MessageFetch one Gmail message (headers, body, attachment list) by id.gmail.get_message
- List DraftsLists the drafts in the user's mailbox.gmail.list_drafts
- List LabelsLists all labels in the user's mailbox.gmail.list_labels
- Mark Read/UnreadMark a Gmail message as read or unread.gmail.mark_read
- Replace DraftReplaces a draft's content.gmail.replace_draft
- Replace LabelUpdates the specified label.gmail.replace_label
- Search MessagesSearch a mailbox and return the matching messages (newest first).gmail.search
- Trash MessageMove a Gmail message to the trash (recoverable for 30 days).gmail.trash
- Update LabelPatch the specified label.gmail.update_label
Templates that use Gmail
- Inbox triage: classify and route emailEvery 15 minutes, fetch the next unread email, classify it (urgent / billing / general) and route urgent ones to the on-call inbox with an auto-acknowledgement.
- Sales inbox: qualify and routePoll the sales mailbox, classify each email as lead / existing customer / vendor, create Iris records for new leads and forward the rest to the right team.
Gmail questions
- How does OCNORA authenticate with Gmail?
- With a stored OAuth 2.0 credential, shaped {"client_id", "client_secret", "refresh_token"}. A connection test can check it when you add it.
- What can I automate with Gmail?
- 18 typed operations and 1 trigger, each with a reference page listing its config fields and the shapes it emits. The credential also drives 2 generic nodes.
- What if the Gmail operation I need is not listed?
- Where Gmail has an HTTP API, call it from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use Gmail?
- Yes: 2 templates, listed above.
- How are Gmail calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first Gmail workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.