All guides

Connector integrations guide

Connect agents to Gmail, Outlook, CRM systems, and calendar apps.

Intermediate18 min readSep 25, 2025
ConnectorsIntegrationsOAuth
Key takeaways
  • Set up OAuth connections for email and calendar providers.
  • Securely manage tokens with automatic refresh.
  • Implement proper scopes and permission handling.

Connector overview

Disruptive Rain connectors enable agents to interact with external services like Gmail, Outlook, HubSpot, and Salesforce.

Users authorize connections via OAuth, and tokens are securely stored and refreshed automatically.

  • Tokens are encrypted at rest.
  • Token refresh is handled automatically.
  • Each connector type has specific required scopes.

Gmail connector setup

Connect Gmail to enable email reading, drafting, and sending through agents. Users authorize via OAuth consent flow.

  • Required scopes: gmail.readonly, gmail.send.
  • Users see a Google consent screen during setup.
  • Tokens are refreshed automatically.

CRM connector setup

Connect HubSpot or Salesforce to enable CRM lookups, contact creation, and deal management through agents.

  • HubSpot: Requires contacts, deals, and companies scopes.
  • Salesforce: Requires api, refresh_token, and offline_access scopes.
  • Both support read and write operations.

Token security

Connector tokens are handled securely with automatic refresh before expiration.

  • Tokens are never exposed in API responses.
  • Refresh happens automatically before expiration.
  • Failed refreshes prompt users to re-authorize.
  • All connection changes are logged for audit.