Skip to main content
A Linked Account is one person’s authenticated connection to a provider, made through a connector profile. Once an account is linked, your agents can run the profile’s actions on it, and its events reach your webhooks.
Where Linked Accounts sit in StackOne: each account comes off a connector profile inside your project and represents one person's connection to a connector.

​
Account linking methods

Depending on your use case, these options exist for allowing users to link accounts:
For Auth Links there’s no frontend callback. Subscribe to account webhooks to know when an account is linked.
The profile picker only offers connector profiles you’re allowed to use. A restricted profile is hidden when linking, in the dashboard and in the Hub, unless you’ve been granted access to it.
You can link accounts directly from the StackOne dashboard without embedding the Hub. The linking flow depends on your organization type and your project role:
Project Admins link accounts for their own organization, for example to share across the project. Project Members link accounts for their own use.
1

Start linking

  1. In the dashboard, open Connectors.
  2. Select the connector.
  3. Click Link Account.
2

Configure the account

Project Members skip this step and link with the project’s default connector profile.
Project Admins set the following:
  • Account Name: Optional. Default is your name in front of the connector name, for example John's Slack. Shown in the accounts list, so you can tell your accounts apart.
Click Continue.
3

Connect the account

Project Admins may change the connector profile if multiple are available.
  1. Enter any required credentials.
  2. Click Connect.
  3. If the provider asks you to authorize, for example through OAuth, complete authorization with the provider.
4

View the Linked Account

Once authentication succeeds, the Linked Account is created. To confirm, open the connector’s page and select the Accounts tab.

​
If linking fails

Linking a new account through a connector profile with account linking disabled fails with a 422 and the error code AccountIntegrationInactiveError. Enable account linking on the connector profile in the dashboard, or link the account through a profile that has it enabled.

​
Manage linked accounts

View, re-authenticate, or remove accounts on the Accounts page, or via the List Accounts API. To update expired credentials, click Reconnect in a Linked Account’s row menu or on its details page. Reconnecting updates the credentials on the existing Linked Account rather than creating a second one.

​
Account status

A Linked Account’s status tells you whether it can currently serve calls. To react to status changes instead of polling, subscribe to the account.updated and account.deleted webhook events.

​
Suspend a Linked Account

A suspended Linked Account can’t be used to call actions, and keeps its credentials so it can be resumed without re-authenticating. Only Project Admins can suspend Linked Accounts, one at a time.
1

Find the Linked Account

Open the Accounts page.
To see only the Linked Accounts on one connector profile, use the Accounts tab of its card on the connector’s page.
2

Suspend it

  1. In the Linked Account’s row, select ⋯, then Suspend.
  2. Enter the ID shown, then select Suspend.
To resume a Linked Account, select Enable in its row menu.

AI Platforms

Point an AI platform at the account you just linked.

Scoping Connectors

Choose which of a connector’s actions and events are exposed.

Shared Accounts

Let several people work through one linked account instead of each linking their own.

Webhooks

Get notified when an account is linked, re-authenticated, or disconnected.