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

# Connectors

> Browse and discover all available StackOne connectors and their actions

## Overview

The **Connectors** page ([app.stackone.com/connectors](https://app.stackone.com/connectors)) shows all available connectors and their actions. Use it to find actions, check parameters, and test them in the Playground.

<CardGroup cols={2}>
  <Card title="Browse All Actions" icon="grid">
    View the complete catalog of actions across all connectors
  </Card>

  <Card title="Filter & Search" icon="magnifying-glass">
    Find specific actions by category, provider, or keyword
  </Card>

  <Card title="View Details" icon="list">
    See action parameters, inputs, outputs, and descriptions
  </Card>

  <Card title="Test Instantly" icon="play">
    Jump to the AI Playground to test any action with real data
  </Card>
</CardGroup>

## Accessing the Connectors Page

1. Navigate to [app.stackone.com/connectors](https://app.stackone.com/connectors)
2. Sign in to your StackOne account
3. Browse connectors and click on any to view its available actions

<Frame caption="The Connectors page showing available connectors and their actions">
  <img src="https://mintcdn.com/stackone-60/jo10TcECbtGQ_qL8/images/guides/connectors-interface.png?fit=max&auto=format&n=jo10TcECbtGQ_qL8&q=85&s=b32305dee69e0ba504fa5b948437f37a" alt="Connectors page listing each connector with its action, profile, and account counts" width="1280" height="800" data-path="images/guides/connectors-interface.png" />
</Frame>

<Tip>
  **Quick access:** You can also access the Connectors page from the sidebar navigation in the StackOne dashboard.
</Tip>

## Understanding Actions

Actions are the building blocks of StackOne connectors. Each action represents a specific operation you can perform with a provider, such as:

* **List operations** - Retrieve collections of records (e.g., list employees, list contacts)
* **Get operations** - Fetch a single record by ID
* **Create operations** - Add new records to a system
* **Update operations** - Modify existing records
* **Delete operations** - Remove records

### Action Types

<AccordionGroup>
  <Accordion title="Provider-Specific Actions" icon="puzzle-piece">
    Direct access to provider APIs. These actions expose the full capabilities of each integration.

    **Examples:**

    * `gong_crm_search_calls` - Search CRM calls in Gong
    * `ashby_list_applications` - List applications from Ashby ATS
    * `workday_list_employees` - List employees from Workday HRIS
    * `salesforce_list_accounts` - List accounts from Salesforce CRM
  </Accordion>

  <Accordion title="Unified Actions" icon="code-branch">
    Standardized actions that work consistently across all providers in a category. Use these when you want your agent or application to work with any provider without provider-specific code.

    **Examples:**

    * `iam_list_users` - List users from Okta, Azure AD, Google Workspace, or any IAM provider
    * `iam_list_groups` - List groups across identity providers
    * `documents_list_files` - List files from Google Drive, SharePoint, Dropbox, or any document provider
    * `documents_download_file` - Download files with a consistent interface

    Unified actions normalize data schemas across providers, so your code works identically regardless of which system your user connects.

    <Tip>
      Want to build unified actions for your own connectors? See the [Connector Engine](/guides/connector-engine/introduction) to create custom connectors with unified schemas.
    </Tip>
  </Accordion>
</AccordionGroup>

## Using the Actions Explorer

### Browsing Connectors

The main page lists all available connectors in a sortable table. Each row shows:

| Column        | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| **Connector** | Connector name and icon, with a **Preview** badge for connectors in preview |
| **Actions**   | Number of actions the connector supports                                    |
| **Profiles**  | Number of [connector profiles](/guides/connector-profiles) configured       |
| **Accounts**  | Number of linked accounts                                                   |

Search by name, or pick from **Popular Connectors** at the top. Click any row to open the connector's detail page.

### Exploring Connector Actions

Selecting a connector opens its detail page, with **Actions**, **Profiles**, **Accounts**, and **Logs** tabs. The header has three actions:

* **Profile** - Configure a [connector profile](/guides/connector-profiles)
* **Link Account** - Connect an account for this connector
* **Use in Agent** - Open setup for MCP clients and the Playground (see below)

The **Actions** tab lists every operation in a table with **Action**, **Description**, and **Tags** columns. Narrow the list with the search bar, the **Tags** filter, or the version selector.

<Tip>
  Click **Use in Agent** to set up access for MCP clients (Claude, Cursor, VS Code, and others) or to open the connector in the Playground.
</Tip>

## From Explorer to Execution

Once you've found an action you want to use, you have several options:

<CardGroup cols={2}>
  <Card title="Test in AI Playground" icon="play" href="/guides/playground">
    Test the action interactively with natural language using LLMs
  </Card>

  <Card title="Use via MCP" icon={<svg fill="currentColor" fillRule="evenodd" height="1em" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><path d="M15.688 2.343a2.588 2.588 0 00-3.61 0l-9.626 9.44a.863.863 0 01-1.203 0 .823.823 0 010-1.18l9.626-9.44a4.313 4.313 0 016.016 0 4.116 4.116 0 011.204 3.54 4.3 4.3 0 013.609 1.18l.05.05a4.115 4.115 0 010 5.9l-8.706 8.537a.274.274 0 000 .393l1.788 1.754a.823.823 0 010 1.18.863.863 0 01-1.203 0l-1.788-1.753a1.92 1.92 0 010-2.754l8.706-8.538a2.47 2.47 0 000-3.54l-.05-.049a2.588 2.588 0 00-3.607-.003l-7.172 7.034-.002.002-.098.097a.863.863 0 01-1.204 0 .823.823 0 010-1.18l7.273-7.133a2.47 2.47 0 00-.003-3.537z"></path><path d="M14.485 4.703a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a4.115 4.115 0 000 5.9 4.314 4.314 0 006.016 0l7.12-6.982a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a2.588 2.588 0 01-3.61 0 2.47 2.47 0 010-3.54l7.12-6.982z"></path></svg>} href="/mcp/quickstart">
    Access the action through StackOne's MCP server
  </Card>

  <Card title="Call via SDK" icon="code" href="/agents/typescript/introduction">
    Use the AI Toolset SDKs to call the action programmatically
  </Card>

  <Card title="Direct API Call" icon="bolt" href="/platform/api-reference/actions/make-an-rpc-call-to-an-action">
    Execute the action directly via the Actions RPC API
  </Card>
</CardGroup>

### Example: Using an Action

After finding an action like `workday_list_employees`, here's how you'd use it:

<Tabs>
  <Tab title="AI Playground">
    1. Go to [app.stackone.com/playground](https://app.stackone.com/playground)
    2. Select your Workday account
    3. Ask: "List all employees from Workday"
    4. The AI will automatically use the `workday_list_employees` action
  </Tab>

  <Tab title="MCP">
    ```json theme={null}
    // The action is automatically available as a tool
    // in any MCP-compatible client
    {
      "tool": "workday_list_employees",
      "arguments": {
        "limit": 100
      }
    }
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```typescript theme={null}
    import { StackOneToolSet } from "@stackone/stackone-client-ts";

    const toolset = new StackOneToolSet();
    const tools = await toolset.fetchTools({
      accountIds: ["workday-account-id"],
      actions: ["workday_list_employees"]
    });

    // Use with your AI framework
    const result = await tools[0].execute({ limit: 100 });
    ```
  </Tab>

  <Tab title="Actions API">
    ```bash theme={null}
    curl -X POST "https://api.stackone.com/actions/rpc" \
      -u "$STACKONE_API_KEY:" \
      -H "x-account-id: YOUR_ACCOUNT_ID" \
      -H "Content-Type: application/json" \
      -d '{
        "action": "workday_list_employees",
        "query": { "page_size": 100 }
      }'
    ```
  </Tab>
</Tabs>

## Best Practices

<AccordionGroup>
  <Accordion title="Start with the Playground" icon="play">
    Before integrating actions into your application, test them in the [AI Playground](/guides/playground) to understand their behavior and outputs.
  </Accordion>

  <Accordion title="Check Action Parameters" icon="sliders">
    Review the required and optional parameters for each action. Some actions require specific inputs to function correctly.
  </Accordion>

  <Accordion title="Monitor Usage" icon="chart-line">
    Use [Request Logs](/guides/request-logs) to monitor action executions and troubleshoot issues.
  </Accordion>
</AccordionGroup>

## Related Resources

<CardGroup cols={3}>
  <Card title="AI Playground" icon="play" href="/guides/playground">
    Test actions interactively with LLMs
  </Card>

  <Card title="MCP Quickstart" icon={<svg fill="currentColor" fillRule="evenodd" height="1em" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><path d="M15.688 2.343a2.588 2.588 0 00-3.61 0l-9.626 9.44a.863.863 0 01-1.203 0 .823.823 0 010-1.18l9.626-9.44a4.313 4.313 0 016.016 0 4.116 4.116 0 011.204 3.54 4.3 4.3 0 013.609 1.18l.05.05a4.115 4.115 0 010 5.9l-8.706 8.537a.274.274 0 000 .393l1.788 1.754a.823.823 0 010 1.18.863.863 0 01-1.203 0l-1.788-1.753a1.92 1.92 0 010-2.754l8.706-8.538a2.47 2.47 0 000-3.54l-.05-.049a2.588 2.588 0 00-3.607-.003l-7.172 7.034-.002.002-.098.097a.863.863 0 01-1.204 0 .823.823 0 010-1.18l7.273-7.133a2.47 2.47 0 00-.003-3.537z"></path><path d="M14.485 4.703a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a4.115 4.115 0 000 5.9 4.314 4.314 0 006.016 0l7.12-6.982a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a2.588 2.588 0 01-3.61 0 2.47 2.47 0 010-3.54l7.12-6.982z"></path></svg>} href="/mcp/quickstart">
    Connect via MCP protocol
  </Card>

  <Card title="Execute Actions" icon="bolt" href="/platform/api-reference/actions/make-an-rpc-call-to-an-action">
    Direct RPC execution guide
  </Card>
</CardGroup>
