> ## Documentation Index > Fetch the complete documentation index at: https://major-5cc5eebc-docs-bot-mr2qm9w6-typctx.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Connectors > Connect your apps to databases, APIs, and storage services. Connectors are the databases, APIs, and storage services your apps connect to. Major manages credentials securely so you never need to handle secrets in your code. ## How connectors work ```mermaid theme={null} flowchart TD subgraph YourApp ["Your App"] App["Application Code"] Client["@major-tech/resource-client"] end Gateway["Major API Gateway"] Resource[("Your Resource")] App -- "Uses" --> Client Client -- "Authenticated Request
(MAJOR_JWT_TOKEN)" --> Gateway Gateway -- "Proxy" --> Resource click Client "https://www.npmjs.com/package/@major-tech/resource-client" style YourApp fill:transparent,stroke:#999,stroke-dasharray: 5 5 style Client fill:#fff,stroke:#333,stroke-width:2px style Gateway fill:#fff,stroke:#333,stroke-width:2px style Resource fill:#fff,stroke:#333,stroke-width:2px ``` * **Secure Flow**: Your app connects to the Major API, which proxies requests to your actual connectors. * **Authentication**: Powered by a `MAJOR_JWT_TOKEN` issued to your session. This token contains your user scopes, ensuring the client can only access what you're permitted to access. * **Generated Clients**: Major generates resource clients for you. You'll find one per resource in `src/clients/`. ## Setting up a connector 1. Navigate to **Organization Settings > Connectors** 2. Click **Add Connector** and select the type 3. Configure the connection details and credentials 4. Attach the connector to your app via the web editor or `major resource manage` Resource credentials are encrypted and never exposed to the client-side application code. ## Per-environment configuration When editing a connector, you can configure each environment independently. This lets you use different credentials or endpoints for staging and production. | Environment | Host | Database | | ----------- | ------------------- | -------------- | | default | prod.example.com | myapp\_prod | | staging | staging.example.com | myapp\_staging | You can also enable **shared configuration** for a resource, which uses a single configuration from the default environment across all environments instead of per-environment configs. When enabled, non-default environment tabs are locked with an explanatory tooltip. See how to create and manage environments for your organization. ## Resource context You can upload context files — database schemas, OpenAPI specs, API documentation, and more — to any connector. The AI assistant uses this context when writing queries and API calls against that resource, so it understands your data model without you having to explain it every time. If your app needs a connector that hasn't been set up yet, the AI will show a setup card in the chat — click it to configure the resource inline without leaving the editor. ## Identity-based authentication For AWS services (S3 and DynamoDB), you can use IAM Assume Role Identities instead of access keys. Create an identity in **Settings > Identities**, review the generated trust policy for your IAM role, and select identity-based authentication when configuring the resource. For GCP services (BigQuery), you can authenticate via a service account JSON key in addition to OAuth. Create a GCP identity in **Settings > Identities** to manage service accounts across resources. Identity-based authentication is more secure and avoids storing long-lived credentials. ## Rate limiting Set hourly and daily invocation limits on any connector to protect downstream services from runaway usage. When a limit is reached, requests return `429 Too Many Requests` until the window resets. Configure limits when creating or editing a connector. ## Available connectors SQL database queries AWS NoSQL database Object storage and files Message queue operations Data warehouse queries SQL Server queries MySQL database queries Google BigQuery datasets Graph database queries Serverless function invocation Any REST API Query any GraphQL endpoint CRM data and SOQL CRM integration CRM records and objects Sales engagement Payments and subscriptions User and org management Spreadsheet access Calendar events and scheduling GA4 reporting Search analytics and sitemaps Read, search, and send email Workspace messaging Communications data and APIs Workspaces, pages, and databases Microsoft SharePoint and OneDrive Meeting transcription and summaries Customer support tickets and data LinkedIn Ads and campaign analytics Facebook and Instagram Ads TikTok advertising campaigns Revenue intelligence data Dataverse CRM integration ## Pipedream Instance Need an app that isn't listed above? Connect your own [Pipedream](/connectors/pipedream) account to reach thousands more integrations from Pipedream's catalog, with the third-party connections managed in your own Pipedream workspace. Connect your own Pipedream account to reach the full app catalog. Don't see the connector you need? Click **Request it** in the Add Connector dialog to submit a request.