@stackone/hub) is a native React <StackOneHub> component that renders directly in your React tree. It offers filtering, search, detailed error messages, and full theming support. It is the recommended way to implement the Hub.
Quick start
1
Install the package
2
Get a session token from your backend
The Hub needs a connect session token to securely communicate with StackOne. This token must be generated server-side to keep your API key secure.To route the session through a specific connector profile (when a provider has more than one), pass its
connector_profile_id when creating the session. See Target a specific connector profile.3
Add the component
4
Let users link their accounts
Your end-users now use the Hub to connect their accounts. Each successful link fires
onSuccess with the linked account id — persist against your user — it’s the account ID you’ll use with every action call.You can also capture it server-side from the account.created webhook event.Properties
TheStackOneHub component accepts these properties:
Theming
The Hub supports full theming with thetheme property:
PartialMalachiteTheme object:
For non-React stacks, use the web components build (
<stackone-hub>). For the older hook API, see @stackone/react-hub on npm.Next steps
Call Actions
With the account linked, call its actions from your product over the Agent SDK, MCP, A2A, or HTTP (RPC).
Getting Started
Return to the end-to-end embedding journey.