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

# Data Sources Overview

> Connect your data to AstroBee

AstroBee connects to your data through file uploads and external connectors. Once connected, you can explore your data and build semantic data layers for natural language querying.

## Connection Methods

### File Uploads

Upload spreadsheets directly to AstroBee:

| Format              | Max Size |
| ------------------- | -------- |
| CSV (.csv)          | 300 MB   |
| Excel (.xlsx, .xls) | 300 MB   |

[Learn more about file uploads →](/data/files)

### External Connectors

Connect business tools via secure [Fivetran](https://www.fivetran.com/) integration:

<CardGroup cols={2}>
  <Card title="Google Sheets" icon="table" href="/data/google-sheets">
    Live sync with specific Google Sheets
  </Card>

  <Card title="Salesforce" icon="cloud" href="/data/salesforce">
    Leads, Opportunities, Accounts
  </Card>

  <Card title="HubSpot" icon="hubspot" href="/data/hubspot">
    Contacts, Deals, Marketing data
  </Card>

  <Card title="LinkedIn Ads" icon="linkedin" href="/data/linkedin-ads">
    Campaign analytics, Ad performance
  </Card>

  <Card title="Reddit Ads" icon="reddit" href="/data/reddit-ads">
    Campaigns, Posts, Engagement
  </Card>

  <Card title="Klaviyo" icon="envelope" href="/data/klaviyo">
    Email campaigns, Flows, Subscribers
  </Card>

  <Card title="Meta Ads" icon="meta" href="/data/meta-ads">
    Campaigns, Audiences, Performance
  </Card>

  <Card title="Google Ads" icon="google" href="/data/google-ads">
    Campaigns, Ad groups, Conversions
  </Card>
</CardGroup>

## How Connectors Work

External data sources use Fivetran for secure, reliable data synchronization:

```mermaid theme={null}
graph LR
    A[Your Data Source] --> B[Fivetran]
    B --> C[AstroBee Warehouse]
    C --> D[Data Layer]
```

1. **Authentication** — You authorize AstroBee to access your data via OAuth
2. **Sync** — Fivetran securely transfers data to your AstroBee warehouse
3. **Analysis** — AstroBee analyzes patterns and discovers relationships
4. **Exploration** — Preview tables and build your data layer

### Security

* **OAuth 2.0** — Industry-standard authorization (credentials never stored)
* **Encryption** — All data encrypted in transit (TLS 1.3) and at rest (AES-256)
* **SOC 2 Certified** — Both Fivetran and AstroBee maintain SOC 2 compliance

[Learn more about security →](/security/overview)

## Adding a Data Source

1. Navigate to **Data Sources** in the sidebar
2. Click **Add New**
3. Select your data source type
4. Complete the authentication flow
5. Wait for initial sync to complete

<Frame caption="Data source selection screen">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/03-add-data-source-options.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=e386783859742f4b3e4daa6fef99f961" alt="Add data source" width="2850" height="1608" data-path="screenshots/03-add-data-source-options.png" />
</Frame>

## After Connecting

Once your data syncs, AstroBee automatically:

* **Detects schemas** — Identifies tables, columns, and data types
* **Analyzes patterns** — Discovers ID formats, email patterns, date formats
* **Finds linkages** — Identifies relationships between tables

You can then:

* Preview table data
* View discovered patterns
* Connect the source to a data layer
* Build entities and relationships

## Data Source Limits

| Plan       | Data Sources | Storage               |
| ---------- | ------------ | --------------------- |
| Free       | 2            | Shared warehouse      |
| Pro        | Unlimited    | Shared warehouse      |
| Enterprise | Unlimited    | Bring Your Own Bucket |

## Next Steps

<CardGroup cols={2}>
  <Card title="Upload Files" icon="upload" href="/data/files">
    Upload CSV or Excel files
  </Card>

  <Card title="Build a Data Layer" icon="sitemap" href="/features/data-layer">
    Create entities from your data
  </Card>
</CardGroup>