Skip to main content
Connects to Gmail via OAuth. Pulls emails, extracts contacts from sender/recipient fields, logs each email as a communication on the matching contact record, and builds email relationship edges in the graph.
Gmail OAuth is currently under Google verification. You may see a warning screen during the OAuth flow. Click “Advanced” → “Go to Supersonic” to proceed.

​
What gets synced

  • Emails — subject, body, sender, recipients (to/cc/bcc), thread ID, timestamps
  • Contacts — auto-created from email addresses. Names are extracted from email headers. Duplicates are merged by email address.
  • Relationships — emailed edges between contacts who exchanged emails, co_threaded for participants in the same thread, works_at linking contacts to companies by email domain

​
What gets filtered

Automated and transactional emails are excluded:
  • No-reply addresses, newsletters, service notifications
  • Emails from known SaaS platforms (GitHub, Slack, Stripe, etc.)
  • Marketing and transactional senders

​
Connect

  1. Go to Sources in the dashboard
  2. Click Connect next to Gmail
  3. Authorize Supersonic in the Google OAuth screen
  4. Initial sync starts automatically

​
Sync frequency

  • Initial sync — pulls all emails (may take a few minutes for large inboxes)
  • Incremental sync — every 5 minutes, checks for new emails since last sync

​
Data access

Emails are stored in the Communication model and linked to contact records. Access them via: 
# List recent emails
supersonic notes list --record <contact-id>

# Or via the timeline
supersonic timeline <contact-id>