← Back to Docs
Features

Inbox Setup

Connect Gmail or Outlook to Pounce for inbound lead capture and conversation tracking via OAuth 2.0.

How Inbox Integration Works

Gmail and Outlook connections are inbound only — they receive leads and track replies. Outbound AI responses are sent through your sending provider (Resend, SendGrid, or Mailgun).

When you connect an inbox, Pounce can:

  1. Receive new leads by email — When someone emails your business, Pounce catches it as a lead
  2. Track conversation replies — When a lead replies, Pounce sees it and continues the conversation
  3. Mark emails as read — Keeps your inbox clean without deleting anything

Connecting Gmail

  1. Go to Settings → Integrations
  2. Select Gmail as your inbox provider
  3. Click Connect Gmail
  4. You’ll be redirected to Google’s OAuth consent screen
  5. Grant read and modify permissions (Pounce never asks for send access)
  6. You’ll be redirected back to Pounce with the connection confirmed

Scopes requested:

  • gmail.readonly — Read your emails
  • gmail.modify — Mark as read, apply labels

Connecting Outlook

  1. Go to Settings → Integrations
  2. Select Outlook as your inbox provider
  3. Click Connect Outlook
  4. You’ll be redirected to Microsoft’s OAuth consent screen
  5. Grant mail read and modify permissions
  6. You’ll be redirected back to Pounce with the connection confirmed

Scopes requested:

  • Mail.Read — Read your emails
  • Mail.ReadWrite — Mark as read, move to folders
  • offline_access — Keep the connection alive

Monitoring Modes

ModeHow It WorksLatency
Push (recommended)Google Pub/Sub or Microsoft Graph webhooks notify Pounce instantly~1-2 seconds
PollingPounce checks your inbox every 5 minutesUp to 5 minutes

Push mode requires your Pounce instance to be accessible from the internet (for webhook delivery). Polling works behind firewalls and NAT.

Using Forms Only (No Inbox)

You don’t have to connect an inbox. If you only use lead forms, Pounce works entirely through form submissions. Inbox integration is optional.

Disconnecting

Go to Settings → Integrations and click Disconnect next to your inbox provider. Pounce stops monitoring your inbox immediately. Previous leads and conversations are preserved.

Troubleshooting

Gmail connection keeps timing out:

  • Make sure your Google Cloud project has the Gmail API enabled
  • Check that your OAuth redirect URI matches your Pounce URL exactly

Not receiving leads from inbox:

  • Check that monitoring is enabled in Settings → Integrations
  • For push mode, verify your Pounce instance is publicly accessible
  • For polling mode, wait up to 5 minutes for the next check

See also: Troubleshooting for more help.

Questions? Contact us or visit Support