> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raycaster.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations Overview

> Connect Raycaster with your email providers and CRM systems for seamless data flow

## Overview

Raycaster integrates with your existing email and CRM tools so you can work without switching between applications. Connect Gmail, Outlook, HubSpot, or Salesforce to sync data, send emails, and manage contacts directly from your workspace.

<Frame caption="The Integrations page showing connected providers and the option to add new integrations">
  <img src="https://mintcdn.com/raycaster/3i8hpJTGgadnQEio/images/integrations-page.png?fit=max&auto=format&n=3i8hpJTGgadnQEio&q=85&s=6be137bc37e5660c0114c30bc661b656" alt="Integrations page" width="3024" height="1964" data-path="images/integrations-page.png" />
</Frame>

## Available Integrations

<CardGroup cols={2}>
  <Card title="Gmail" icon="envelope" href="/advanced/integrations/gmail" color="#4F5DFF">
    Connect your Google account to send, receive, and sync emails directly from Raycaster.
  </Card>

  <Card title="Outlook" icon="envelope" href="/advanced/integrations/outlook" color="#4F5DFF">
    Connect your Microsoft account for full Outlook email integration.
  </Card>

  <Card title="HubSpot" icon="hubspot" href="/advanced/integrations/hubspot" color="#7B85FF">
    Sync contacts and companies between your HubSpot CRM and Raycaster sheets.
  </Card>

  <Card title="Salesforce" icon="salesforce" href="/advanced/integrations/salesforce" color="#7B85FF">
    Sync contacts and accounts between Salesforce and Raycaster sheets.
  </Card>
</CardGroup>

## Integration Types

### Email Integrations (Gmail & Outlook)

Email integrations let you:

* **Send emails** directly from Raycaster using your connected accounts
* **Sync emails** to view your inbox within the workspace
* **Run email sequences** for automated multi-step outreach
* **Connect multiple accounts** per provider (e.g., work and personal Gmail)
* **Choose scope** — keep an account personal or share it organization-wide

### CRM Integrations (HubSpot & Salesforce)

CRM integrations let you:

* **Pull data** from your CRM into Raycaster sheets
* **Push data** from Raycaster sheets back to your CRM
* **Map fields** between sheet columns and CRM fields
* **Sync contacts and companies** with a single click
* **Use CRM templates** — pre-built sheets optimized for CRM data

## Setting Up an Integration

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Settings** in the sidebar, then click **Integrations**.
  </Step>

  <Step title="Select a Provider">
    Click **"Add Integration"** next to the service you want to connect (Gmail, Outlook, HubSpot, or Salesforce).
  </Step>

  <Step title="Authorize">
    Sign in to your account and grant Raycaster permission to access your data. Authentication is handled via secure OAuth — Raycaster never stores your passwords.
  </Step>

  <Step title="Choose Scope">
    For email integrations, choose whether this connection is:

    * **Personal** — Only you can send and view emails from this account
    * **Organization** — All team members can use this account
  </Step>

  <Step title="Start Using">
    Your integration is now active. For email, you can start composing and sending. For CRM, configure field mapping and sync.
  </Step>
</Steps>

## Integration Scopes

| Scope            | Who Can Use                     | Best For                                    |
| ---------------- | ------------------------------- | ------------------------------------------- |
| **Personal**     | Only the user who connected     | Individual work email, personal CRM testing |
| **Organization** | All members of the organization | Shared team inbox, company CRM connection   |

<Note>
  CRM integrations (HubSpot, Salesforce) are always organization-scoped. Each organization has one connection per CRM provider, shared by all members.
</Note>

## Managing Integrations

From the integrations settings page, you can:

* **View status** — See which integrations are active, including the connected email address and last sync time
* **Sync manually** — Trigger an on-demand sync for any connected integration
* **Disconnect** — Remove an integration when it's no longer needed
* **Add accounts** — Connect additional email accounts (email integrations support multiple accounts)

## Security

All integrations use OAuth 2.0 for authentication:

* **No passwords stored** — Authentication tokens are managed securely by the integration proxy
* **Scoped permissions** — Raycaster only requests the minimum permissions needed (e.g., read and send email)
* **Rate limiting** — API calls are automatically rate-limited to prevent throttling
* **Multi-tenant isolation** — Each organization's data is fully isolated
