Skip to main content
Noxus integrates with Google Workspace services using OAuth 2.0 authentication, allowing you to access Gmail, Drive, Sheets, Docs, Calendar, and more.

Supported Google Services

ServiceAuthenticationKey Capabilities
GmailOAuth 2.0Send/receive emails, read threads, manage labels
Google DriveOAuth 2.0Upload/download files, folder management, sharing
Google SheetsOAuth 2.0Read/write data, create sheets, manage workbooks
Google DocsOAuth 2.0Create/edit documents, export formats
Google CalendarOAuth 2.0Create events, manage calendars, check availability

Authentication: OAuth 2.0

Description

Google integrations use OAuth 2.0 to authenticate as a specific user. Users grant permission through Google’s consent screen, and Noxus can then access the resources that user has permission to view or modify.

When to Use

Ideal For

  • User-specific actions (sending email as a user)
  • Personal file access
  • Individual calendar management
  • Actions requiring user attribution

Characteristics

  • Permission Type: User-delegated
  • Setup: Interactive consent flow
  • Access Scope: User’s accessible resources
  • Best For: Personal automation, user workflows

Authentication Flow

Setup Process

1

Navigate to Integrations

Go to Integrations in your Noxus workspace
2

Select Google Service

Choose the Google service (Gmail, Drive, Sheets, Docs, or Calendar)
3

Click Connect

Click the Connect button
4

Sign In

Sign in with your Google account
5

Review Permissions

Review the requested permissions carefully
6

Grant Access

Click “Allow” to grant permissions
7

Complete

Connection is active and ready to use in flows

Permissions by Service

Scopes Required:
  • gmail.readonly - Read email and settings
  • gmail.send - Send email on your behalf
  • gmail.modify - Manage drafts and send email
Capabilities:
  • Read emails and threads
  • Send emails
  • Create and manage labels
  • Search messages
  • Manage drafts
Scopes Required:
  • drive.readonly - View files and folders
  • drive.file - View and manage files created by Noxus
  • drive - Full Drive access
Capabilities:
  • Upload and download files
  • Create and manage folders
  • Share files and folders
  • Search Drive
  • Manage permissions
Scopes Required:
  • spreadsheets.readonly - View spreadsheets
  • spreadsheets - Create and edit spreadsheets
Capabilities:
  • Read sheet data
  • Write data to cells
  • Create new sheets
  • Format cells
  • Manage worksheets
Scopes Required:
  • documents.readonly - View documents
  • documents - Create and edit documents
Capabilities:
  • Read document content
  • Create new documents
  • Edit existing documents
  • Export to different formats
Scopes Required:
  • calendar.readonly - View calendars
  • calendar.events - Manage events
  • calendar - Full calendar access
Capabilities:
  • Create calendar events
  • Read event details
  • Update events
  • Check availability
  • Manage calendars

Common Use Cases

Email Processing Workflows:
  • Monitor inbox for specific emails
  • Automatically respond to inquiries
  • Extract data from email attachments
  • Route emails based on content
  • Send bulk personalized emails
Example Flow:

Security Best Practices

Permission Management

  • Request only necessary scopes
  • Regularly review connected apps
  • Remove unused connections
  • Monitor access logs

Token Security

  • Tokens stored encrypted
  • Automatic token refresh
  • Revoke access when needed
  • Audit token usage

Troubleshooting

Possible Causes:
  • Invalid Google account
  • Permissions not granted
  • OAuth flow interrupted
  • Network connectivity issues
Solutions:
  • Try reconnecting with a different account
  • Ensure all permissions are approved
  • Complete the OAuth flow without closing windows
  • Check network connection
Possible Causes:
  • Missing required scopes
  • User revoked access
  • Resource access restrictions
  • Admin disabled app access
Solutions:
  • Reconnect to grant additional scopes
  • Check Google account permissions
  • Verify resource sharing settings
  • Contact Google Workspace admin
Possible Causes:
  • API rate limits reached
  • Too many concurrent requests
  • Daily quota exceeded
Solutions:
  • Implement rate limiting in flows
  • Reduce request frequency
  • Use batch operations when available
  • Upgrade Google Workspace plan if needed

Next Steps