Google Workspace Integration

Connect Gmail, Google Drive, Docs, and Sheets to automate your workflow.

What You Can Do

• Send automated emails via Gmail
• Create and update Google Docs
• Read and write to Google Sheets
• Upload files to Google Drive
• Create Google Calendar events
• Search and organize Drive files

Setup Instructions

1. Go to Connections in your ARKA AI dashboard
2. Find the Google Workspace card
3. Click "Connect"
4. You'll be redirected to Google's authorization page
5. Select your Google account
6. Review and accept permissions
7. You'll be redirected back to ARKA AI with Google connected

Required Permissions

ARKA AI requests these Google API scopes:

• gmail.send - Send emails on your behalf
• drive.file - Create and access ARKA AI created files
• documents - Create and edit Google Docs
• spreadsheets - Read and write Google Sheets
• calendar.events - Create and manage calendar events
• userinfo.email - Access your email address
• userinfo.profile - View your basic profile info

Common Use Cases

Gmail Features

Sending Emails

Send emails with:

• Custom subject lines
• HTML formatted body
• Multiple recipients (to, cc, bcc)
• File attachments
• Reply-to addresses

Email Templates

Use AI to generate professional emails:

• Sales outreach
• Customer support responses
• Meeting invitations
• Follow-up sequences
• Newsletter content

Google Drive Features

• Upload files and documents
• Create folders and organize files
• Share files with specific permissions
• Search for files by name or content
• Generate shareable links

Google Docs Features

• Create new documents from scratch
• Use templates for common document types
• Format text (headings, bold, italic, lists)
• Insert images and tables
• Apply paragraph styles

Google Sheets Features

• Read data from existing spreadsheets
• Write data to specific cells or ranges
• Create new sheets and tabs
• Apply formulas and formatting
• Generate charts and pivot tables

Troubleshooting

"Permission Denied" Error

If you see permission errors:

• Ensure you accepted all requested permissions during setup
• Reconnect the integration to refresh permissions
• Check that your Google Workspace admin hasn't restricted API access
• Verify the file or resource you're accessing allows editing

Emails Not Sending

If emails aren't being sent:

• Check Gmail's sending limits (500 emails/day for free accounts)
• Verify recipient email addresses are valid
• Ensure content doesn't trigger spam filters
• Check if your Gmail account has sending restrictions

File Access Failed

If you can't access Drive files:

• Verify the file exists and hasn't been deleted
• Check file sharing permissions
• Ensure the file ID is correct
• Try accessing the file manually in Google Drive

Security & Privacy

• OAuth tokens are encrypted and stored securely
• We only access files created by ARKA AI or explicitly shared
• Emails are sent through Google's secure infrastructure
• You can revoke access anytime from Google Account settings
• We never read your existing emails or private documents
• All API requests use HTTPS encryption

Best Practices

Next Steps