Skip to main content
Connect your agent to one or more of the systems you already use — Zendesk, Gmail, Salesforce, and hundreds more — and run your first actions.
Quickstart steps: Connect a system, Link an account, Run actions

​
Connect through the dashboard

If you currently don’t have an organization or project, you’ll be prompted to create them on first login. Once that’s done, continue below to start using a connector.

​
Setup Connector Profile

Before linking an account, you need a Connector Profile. It holds the connector’s authentication and decides which actions and events your agent can use. You create it on the connector’s own page.
1

Open the connector

  1. In the StackOne dashboard sidebar, open Connectors.
  2. Search for the connector you want to use (e.g. Zendesk, Gmail, Salesforce) and select it.
The connector page shows a row of cards. Library lists every action and event the connector offers, and each of your profiles for this connector gets a card next to it.
  1. Click Add Profile. This starts a Draft Profile.
Gmail connector page with a Library card, an Add Profile card, and Actions, Accounts and Logs tabs

Connector page: the Library card and the Add Profile card

2

Choose what your agent can access

The draft starts with every action selected. To start small, turn off the switch in the table header to clear the selection, then turn on a few read actions. If the connector supports events, turn them on in the Events tab and choose the webhook each one delivers to. See Scoping Connectors.The Auth Method filter shows which authentication type the draft is built for. A profile can only include actions its authentication type can run, so pick another method there if the actions you need are hidden.
Draft Profile on the Gmail connector page with three read actions switched on and a bar showing 3 Selected with Cancel and Continue

Draft Profile: three read actions selected

Click Continue.
3

Set up authentication

The Create Profile panel opens.
  1. Leave the Profile Name as the default value. It’s a label to tell your profiles apart in the dashboard.
  2. If more than one option exists, choose the Authentication Type you want to use. The link next to it opens that method’s setup guide.
  3. Fill in any credential fields the connector needs, such as a Client ID and Client Secret or an API key. If you’re using your own OAuth app, copy the Callback URL into its settings with the provider.
  4. Leave Update strategy at its default. It controls which connector versions the profile moves to. See Connector Versioning.
A profile’s Authentication Type can’t be changed once the profile exists. To use another type later, create another profile for the same connector.
Some connectors need extra configuration on the provider side. Check the Connector Guides and follow the relevant Connector Profile guide.
Create Profile panel showing Profile Name, Authentication Type set to OAuth 2.0, the Callback URL with a copy button, the scopes the selected actions need, and the Client ID field

Create Profile panel for an OAuth connector

  1. Click Create Profile. The profile appears as a card on the connector page.
If you’re a Project Admin or Organization Admin, the profile is ready to link an account. If you’re a Project Member, it’s created with account linking disabled, and a Project Admin or Organization Admin has to enable account linking first.
There are multiple methods for linking an account. In this guide, we’ll link one directly through the StackOne dashboard.
1

Click Link Account

At the top of the connector page, click Link Account. It becomes available once the connector has a profile. This opens the Link an Account popup.
2

Select Method 2 - Authenticate Now

Link an Account popup showing the three connection methods with Method 2 - Authenticate Now selected

Link an Account popup: Method 2 - Authenticate Now

3

Enter Owner Details

These fields identify which of your customers the account belongs to. See Multi-Tenant Accounts for how they tie accounts to your clients.For this walkthrough, leave the default values and click Next.
4

Confirm Integration Hub Preferences

Confirm the Connector Profile you configured earlier is selected, then click Next.
Depending on the Connector there may be additional fields to complete and/or additional configuration on the provider system. Click Connection Guide in the top right for more details if needed.
5

Connect and authenticate

Click Connect. You may need to complete authentication with the provider (e.g. via OAuth). A new window will pop up prompting you to sign in as needed.Once authorization is complete, your Account will now be linked in StackOne.

Dashboard Account Linking

​
Call Actions

With a linked account in place, check it works in the Playground. Run actions in natural language, no code.
1
In the dashboard sidebar, open Playground.
2
Click Manage Action Sources, select the account you linked, and click Done.
3
Try a prompt like:

​
Next steps

AI Platforms (MCP)

Add the connector’s actions to ChatGPT, Claude, Cursor, and more through the StackOne MCP server. Each user signs in with OAuth.

Protocols & SDKs

Call the connector from your own code with the Agent SDK, MCP, A2A, or RPC/HTTP.