Connecting Gmail
Connect your Gmail account to sync emails and send messages from within Shorebird OS.
Prerequisites
- Active Google/Gmail account
- Pop-up blocker disabled for Shorebird OS
- Admin approval (if using Google Workspace)
Step-by-Step Connection
1. Navigate to Settings
Go to Settings → Integrations → Email
2. Click Connect Gmail
Click the Connect Gmail button.
3. Authorize
- Google sign-in popup appears
- Select your Gmail account
- Review permissions requested
- Click Allow
4. Confirm Connection
Once authorized, you'll see:
- Your connected email address
- Sync status
- Connection date
Permissions Required
Shorebird OS requests these permissions:
| Permission | Why Needed |
|---|---|
| Read email | Sync inbox to Shorebird OS |
| Send email | Send emails from app |
| Manage labels | Organize synced emails |
Troubleshooting
Pop-up blocked
Allow pop-ups for app.shorebirdos.com in your browser.
"Access blocked" message
Your Google Workspace admin may need to approve Shorebird OS.
Connection fails
- Try again in incognito mode
- Clear browser cache
- Contact support