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

# Integrations

> Connect your agent to any tool or service — 30+ built-in, unlimited via API

Your Spark agent can connect to **any tool or service that has an API** — not just the ones listed on this page. The built-in integrations below are one-click setup, but your agent isn't limited to them.

<Info>
  **Your agent can work with any software.** If a tool has an API, OAuth, webhooks, or any kind of programmatic access, your agent can use it. Just provide the credentials (API key, access token, OAuth connection) and your agent figures out the rest. The 30+ built-in integrations are just the ones with pre-configured setup — your agent's capabilities are unlimited.
</Info>

## Built-In vs. Custom Integrations

|                  | Built-In (30+)                                     | Any API                                                          |
| ---------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
| **Setup**        | Click connect, paste API key                       | Provide credentials + API docs as a knowledge file               |
| **Examples**     | Gmail, Slack, Stripe, GitHub, HubSpot              | QuickBooks, Salesforce, Basecamp, your internal tools            |
| **How it works** | Pre-configured — agent knows the API automatically | Agent reads the API documentation you provide and figures it out |
| **Limitations**  | None                                               | None — if the service has an API, your agent can use it          |

The key insight: **your agent is a general-purpose operator, not a pre-built connector.** It can read API documentation, authenticate with credentials, make HTTP requests, and interpret responses. This means the integrations page is a starting point, not a ceiling.

## Your Agent Doesn't Just Read — It Acts

This is critical to understand: your agent doesn't just pull data from these platforms. **It performs actions on them.** You talk to your agent, and it goes and does the work across whatever tools you've connected.

<Tabs>
  <Tab title="Examples">
    > "Update the Q3 revenue forecast in Google Sheets to reflect the new deal we just closed"
    >
    > "Create a Jira ticket for the checkout bug the customer reported, assign it to the engineering team, and mark it as high priority"
    >
    > "Review the latest PR on GitHub, check if the tests pass, and leave a comment with your analysis"
    >
    > "Send an email to the client confirming their appointment, then add it to Google Calendar and create a follow-up task in Asana for next week"
    >
    > "Check our Stripe dashboard, find all customers whose subscription failed this month, and draft a re-engagement email for each one"
    >
    > "Add a new row to our Airtable tracking sheet with the vendor's quote details, then update the Notion procurement page with the status"
  </Tab>

  <Tab title="What's Actually Happening">
    When you say "update Google Sheets," your agent isn't just noting it down for you to do later. It:

    1. Authenticates with the Google Sheets API using your credentials
    2. Opens the correct spreadsheet
    3. Finds the right cell
    4. Updates the value
    5. Confirms it's done

    The same applies to every integration. Your agent is **directly operating** these tools — creating Jira tickets, merging GitHub PRs, sending emails, updating Airtable records, scheduling calendar events. You just tell it what to do in plain language.
  </Tab>
</Tabs>

**Your agent is an operator across your entire tool stack.** It doesn't matter if the work needs to happen in Gmail, Jira, Stripe, Google Sheets, or Slack — you talk to one agent, and it handles everything across all your connected platforms. No switching tabs, no manual data entry, no copy-pasting between tools.

## How Built-In Integrations Work

1. Go to **Integrations** in your workspace sidebar
2. Find the tool you want to connect
3. Add your API key or credentials
4. Your agent automatically gets access on its next restart

That's it. No code, no configuration files.

## Available Integrations

### 🌐 Web & Search

| Integration      | What Your Agent Can Do                                                   |
| ---------------- | ------------------------------------------------------------------------ |
| **Brave Search** | Search the web for real-time information, research, competitive analysis |
| **Tavily**       | AI-optimized web search with structured results                          |
| **Puppeteer**    | Browse websites, scrape data, interact with web pages                    |

### 💻 Development

| Integration | What Your Agent Can Do                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------------------ |
| **GitHub**  | Create issues, review and comment on PRs, merge branches, check CI status, manage releases                   |
| **Linear**  | Create and assign issues, move through workflows, update priorities, track sprint progress                   |
| **Jira**    | Create and assign tickets, transition statuses, add comments, search and filter issues, link related tickets |
| **Sentry**  | Monitor errors in real-time, assess severity, link to relevant code, alert on new issues                     |

### 🎨 Design

| Integration | What Your Agent Can Do                            |
| ----------- | ------------------------------------------------- |
| **Figma**   | Access design files, read comments, export assets |
| **Canva**   | Interact with Canva designs and assets            |
| **Miro**    | Access boards, read content, manage collaboration |

### 📋 Productivity

| Integration         | What Your Agent Can Do                                                                                |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| **Notion**          | Create and edit pages, update databases, build wikis, manage team documentation                       |
| **Google Drive**    | Create documents, organize folders, search across all files, share with collaborators                 |
| **Google Calendar** | Create and move events, check availability, send invites, manage multiple calendars                   |
| **Zoom**            | Automatically generate meeting links, view scheduled meetings, and add Zoom links to calendar invites |
| **Google Sheets**   | Read, write, and update cells, create new sheets, build formulas, generate reports from data          |
| **Airtable**        | Create and update records, query views, manage bases, build reports from structured data              |
| **Trello**          | Create and move cards, manage lists, add checklists, assign members, update due dates                 |
| **Asana**           | Create and assign tasks, set due dates, update project status, track milestones                       |

### 💬 Communication

| Integration  | What Your Agent Can Do                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------- |
| **Gmail**    | Read and search inbox, compose and send emails, reply to threads, manage labels, draft follow-ups             |
| **Outlook**  | Read and send email, manage your Outlook calendar, create events with Teams meeting links                     |
| **Slack**    | Send messages to any channel, reply in threads, react to messages, read conversation history, DM team members |
| **Discord**  | Send messages, manage channels, respond to users, moderate conversations                                      |
| **Twilio**   | Make outbound phone calls, send and receive SMS, manage phone numbers, record calls                           |
| **SendGrid** | Send transactional and marketing emails, manage contact lists, track delivery                                 |

### 🗄️ Data & Payments

| Integration    | What Your Agent Can Do                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------ |
| **PostgreSQL** | Query databases, insert and update records, run reports, build data pipelines                    |
| **MySQL**      | Query databases, insert and update records, generate reports from live data                      |
| **Stripe**     | Look up customers and subscriptions, check payment status, pull revenue reports, manage invoices |

### 📈 Marketing

| Integration   | What Your Agent Can Do                                                                             |
| ------------- | -------------------------------------------------------------------------------------------------- |
| **HubSpot**   | Create and update contacts, manage deals and pipeline, trigger workflows, pull marketing analytics |
| **Meta Ads**  | Monitor campaign performance, analyze ad spend, track conversions, generate ROI reports            |
| **Mailchimp** | Create and send campaigns, manage subscriber lists, build segments, track open and click rates     |
| **Zendesk**   | Create and update tickets, assign to agents, track resolution times, pull support analytics        |

### 🛒 Commerce

| Integration     | What Your Agent Can Do                                                                                |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Shopify**     | Manage products and inventory, process orders, update pricing, pull sales analytics, manage customers |
| **WooCommerce** | Update products, track orders, manage inventory, pull store performance data                          |
| **Square**      | Look up transactions, manage inventory, track sales trends, pull customer purchase history            |

## Setting Up an Integration

<Steps>
  <Step title="Navigate to Integrations">
    Go to your workspace and click **Integrations** in the sidebar.
  </Step>

  <Step title="Find Your Tool">
    Browse by category or search for the integration you need.
  </Step>

  <Step title="Add Credentials">
    Each integration needs different credentials — typically an API key or access token. Click **Connect** and fill in the required fields.
  </Step>

  <Step title="Agent Restart">
    Your agent picks up new integrations on restart. You can trigger a restart from the agent's detail page, or it happens automatically.
  </Step>
</Steps>

<Tip>
  Not sure where to find your API key? Each integration's connect dialog includes a link to the service's documentation where you can generate credentials.
</Tip>

## OAuth Integrations

Some integrations use OAuth — meaning you sign in with your existing account instead of copying API keys:

* **Gmail** — sign in with your Google account to grant email access
* **Google Calendar** — sign in to grant calendar read/write access
* **Outlook** — sign in with Microsoft to grant email and calendar access (see [Outlook](/integrations/outlook))
* **Linear** — sign in with your Linear workspace; no API key needed

OAuth integrations are more secure because your password is never shared with Spark. You authorize specific permissions, and you can revoke access anytime from the provider's account settings.

<Note>
  If you connect both Google and Microsoft, your workspace's Email and Calendar tabs use the most recently connected provider.
</Note>

## What Happens After You Connect

Once an integration is connected:

1. **Your agent knows about it** — it can see what tools are available in its configuration
2. **You can ask it to use them** — "Check my Gmail for unread emails" or "Create a GitHub issue for this bug"
3. **Scheduled tasks can use them** — "Every morning, check Slack for any messages I missed overnight"
4. **Automations can use them** — webhook triggers can instruct the agent to use connected integrations as part of processing

<Warning>
  Integration credentials are encrypted and stored securely. Your agent accesses them at runtime — they're never exposed in chat or logs.
</Warning>

## Can't Find What You Need?

If you need an integration that isn't listed, your agent can still interact with most services using their API directly. Just provide the API documentation in a knowledge file and your agent can make HTTP requests to any service.

You can also connect external services through **webhooks** — see the [Webhooks guide](/integrations/webhooks) for details on receiving data from any service that supports webhook notifications.