Connecting Gmail

Connect your Gmail account to inbox.dog to start automating your email workflow.

How It Works

inbox.dog uses Google OAuth to securely access your Gmail account. You control what inbox.dog can access, and you can revoke access at any time.

Step-by-Step Guide

1. Sign In

  1. Go to inbox.dog
  2. Click "Sign in with Google"
  3. Select your Google account

2. Authorize Gmail Access

After signing in, you'll be prompted to connect your Gmail:

  1. Click "Connect Gmail" in the dashboard
  2. Review the permissions:
    • Read emails - To process and analyze messages
    • Modify emails - To reply, label, archive, and take actions
  3. Click "Allow" to authorize

3. Verify Connection

Once connected, you'll see:

  • Your Gmail address in the account switcher
  • Active connection status
  • Ability to create agents that watch your inbox

Permissions Explained

inbox.dog requests these Gmail permissions:

  • gmail.readonly - Read your emails (required for processing)
  • gmail.modify - Reply, label, archive, and manage emails (required for agent actions)

These permissions are standard for email automation tools and are the minimum required for inbox.dog to function.

Security

  • OAuth 2.0 - Industry-standard authentication
  • Encrypted tokens - Your Gmail tokens are encrypted at rest
  • No password storage - We never see or store your Google password
  • Revocable access - Disconnect anytime from your Google account settings

Multiple Accounts

You can connect multiple Gmail accounts:

  1. Click your account switcher in the top navigation
  2. Select "Add Account"
  3. Complete the OAuth flow for the new account
  4. Switch between accounts anytime

Each account can have its own set of agents and configurations.

Troubleshooting

"Connection Failed"

  • Check your internet connection
  • Ensure pop-ups aren't blocked
  • Try disconnecting and reconnecting

"Permission Denied"

  • Make sure you clicked "Allow" in the Google consent screen
  • Check that you're using the correct Google account
  • Revoke and re-authorize if needed

"Token Expired"

  • Tokens automatically refresh, but if issues persist:
  • Disconnect and reconnect your Gmail account
  • Check your Google account security settings

Next Steps