AI agent integrations for SaaS. Give your agent every system your customers use.

Scroll to explore, or choose a step↓

1. 01 Configure connectors In StackOne Choose the connectors your product offers.

   Your admin picks the connectors in the StackOne dashboard and sets up a connector profile (opens in a new tab) for each one: how it signs in and which actions your agent may use.

   app.stackone.com/connectors/workday

   Connectors

   Connectors Workday

   Workday

   + Add Profile + Link Account Use in Agent

   Workday is a cloud-based enterprise platform for human capital management, financial management, analytics, and workforce planning.

   LibraryExplore all the actions & events available on the Workday connector. Profile HR agent 4 actions Profile Read only 3 actions + Add Profile

   Actions 162EventsAccountsAccessLogs

   Search for Actions...

   AllReadWriteDeleteSearch

   ActionDescriptionTypeEnabled

   Search Workers Finds workers by name or employee ID and returns a compact record with the worker WID, person ID and current job. Search

   Get Worker Retrieves staffing details for a specific worker by Workday ID. Read

   List Worker Time Off Entries Retrieves all time off entries for a specific worker. Read

   Create Time Off Request (SOAP) Submits a time off request for a worker via the Absence Management SOAP web service. Write

   Update Time Off Request Corrects or deletes existing time off entries for a worker by initiating the Correct Time Off business process via the Absence Management REST API. Write

   Create Termination (SOAP) Terminate an employee with reason codes, last day of work, rehire eligibility, regrettable flag, and close-position handling using the Workday Staffing SOAP Terminate_Employee business process. Write

   156 more actions

2. 02 Connect accounts In your product Users link their systems inside your product.

   Embed the StackOne Hub (opens in a new tab) as a React or web component in your colours, or send an auth link. StackOne stores each credential and refreshes it.

   app.yourproduct.com/settings/integrations

   Your product Integrations

   Northwind OverviewAgentActivityIntegrations Settings

   IntegrationsConnect the tools your team uses. Your agent works in the accounts you link here.

   • WorkdayHRIS Connect Connected
   • Oracle Fusion HCMHRIS Connect Connected
   • BambooHRHRIS Connect Connected
   • PersonioHRIS Connect Connected
   • GreenhouseRecruiting Connect Connected
   • HubSpotCRM Connect Connected
   • JiraProject management Connect Connected
   • SlackMessaging Connect Connected

   Choose Connect on any system to open the Hub for it.

   IntegrationsPage.tsx

   ReactWeb componentAuth link

   Copy

   import { StackOneHub } from "@stackone/hub";
   
   <StackOneHub
     token={connectSessionToken}
     theme={{ colors: { secondary: { background: "#0f766e", foreground: "#ffffff" } } }}
     onSuccess={({ id, provider }) => saveAccount(customerId, id, provider)}
   />

   import "@stackone/hub/webcomponent";
   
   const hub = document.createElement("stackone-hub");
   hub.setAttribute("token", connectSessionToken);
   hub.setAttribute("show-footer-links", "false");
   hub.addEventListener("success", (e) => saveAccount(customerId, e.detail.id, e.detail.provider));
   document.querySelector("#integrations").append(hub);

   # No front end needed: send the link by email or in-app
   curl https://api.stackone.com/connect_sessions \
     -u "$STACKONE_API_KEY:" \
     -H "Content-Type: application/json" \
     -d '{
       "origin_owner_id": "northwind",
       "origin_owner_name": "Northwind"
     }'
   # The response includes auth_link_url

   In your app Read the docs (opens in a new tab)

3. 03 Discover tools Optional Show what the agent can do.

   Build your agent's tools menu from the connectors and actions endpoints (opens in a new tab), so each customer sees what their linked systems offer.

   tools-menu.sh

   curl

   Copy

   # The systems your customers can connect
   curl "https://api.stackone.com/v2/connectors?key=workday,okta" \
     -u "$STACKONE_API_KEY:"
   
   # The actions behind one customer's linked accounts
   curl --globoff "https://api.stackone.com/actions?filter[connectors]=workday,okta&filter[account_ids]=<account id>" \
     -u "$STACKONE_API_KEY:"

   Your backend Read the docs (opens in a new tab)

   app.yourproduct.com/agent/tools

   Your product Agent tools

   Northwind OverviewAgentActivityIntegrations Settings

   Tools your agent can useFrom the systems Northwind has connected.

   • Workday12 actions on
   • Okta4 actions on
   • SlackNot connected

   • Get workerRead a worker's profile and job Enabled
   • List workersFind people by name, team or status Enabled
   • Create time off requestBook leave for a worker Enabled
   • Create terminationEnd a worker's employment Disabled

   Your agent's toolset · Northwind

   16 actions on

   GET /actions?filter[account_ids]=…

4. 04 Act on accounts Your backend Your agent acts on each customer's own linked accounts.

   Use the AI SDK (opens in a new tab) with your agent framework. Scope tool search and every action to your customer's linked account. The agent finds the tools and runs the task.

   agent.ts

   TypeScriptPython

   Copy

   Imports and customer account6 lines

   import { anthropic } from "@ai-sdk/anthropic";
   import { ToolLoopAgent } from "ai";
   import { StackOneToolSet } from "@stackone/ai";
   
   // Look up this connection from your authenticated customer's session.
   if (!customerAccountId) throw new Error("Connect Workday first");

   // Tool search: the agent finds and runs actions in this customer's account only
   const toolset = new StackOneToolSet({
     accountId: customerAccountId,
     toolMode: "search_execute",
   });
   const tools = await toolset.fetchTools();
   
   const agent = new ToolLoopAgent({
     model: anthropic("claude-sonnet-5-5"),
     instructions: "Find the tools you need. Ask for any missing details.",
     tools: await tools.toAISDK(),
   });
   const { text } = await agent.generate({
     prompt: "Submit Dana Reyes's leave request for 23 October 2026.",
   });

   Imports and customer account8 lines

   from pydantic_ai import Agent
   from stackone_ai import StackOneToolSet
   
   # Look up this connection from your authenticated customer's session.
   if not customer_account_id:
       raise ValueError("Connect Workday first")
   toolset = StackOneToolSet(account_id=customer_account_id, search={"method": "auto"})
   

   # Tool search: only the actions this task needs, from this customer's account
   tools = toolset.search_tools(
       "submit a time-off request",
       account_ids=[customer_account_id],
       top_k=5,
   ).to_pydantic_ai()
   
   agent = Agent(
       "openai:gpt-5.4",
       tools=tools,
       instructions="Ask for any missing details before acting.",
   )
   result = agent.run_sync("Submit annual leave for Dana Reyes on 23 October 2026.")
   print(result.output)

   Your backend Read the docs (opens in a new tab)

   app.yourproduct.com/assistant

   Your product Assistant

   Northwind OverviewAgentActivityIntegrations Settings

   Book Friday off for Dana Reyes.

   Your agentWorking…

   Tool searchSearching3 of 35,000+ actions

   • workday_get_workerRunningRead
   • workday_create_time_off_requestRunningDone

   I've submitted Dana's leave request for Friday.

   Ask your agent anything

   Input tokens this run

   95% fewer

   5.5k with tool search vs 109.4k with every Workday tool

   Workdaynow

   Time off requested

   Dana Reyes · Friday

   via workday_create_time_off_request

5. 05 React to events Your backend Changes in their systems start runs.

   Native webhooks and synthetic events arrive at one endpoint, including from systems with no webhooks of their own.

   webhooks.ts

   TypeScript

   Copy

   Signature check10 lines

   import { createHmac, timingSafeEqual } from "node:crypto";
   
   // x-stackone-signature: HMAC-SHA256 of the raw body with your signing secret, base64url.
   function isSignatureValid(signature: string | undefined, rawBody: Buffer, secret: string) {
     if (!signature) return false;
     const expected = Buffer.from(createHmac("sha256", secret).update(rawBody).digest("base64url"));
     const given = Buffer.from(signature);
     return expected.length === given.length && timingSafeEqual(expected, given);
   }
   

   // Register this route before any app.use(express.json()), which would consume the raw body.
   app.post("/webhooks/stackone", express.raw({ type: "application/json" }), (req, res) => {
     if (!isSignatureValid(req.get("x-stackone-signature"), req.body, SIGNING_SECRET)) {
       return res.sendStatus(401);
     }
     const { event, account_id, record_id, event_data } = JSON.parse(req.body.toString());
   
     if (event === "workday_list_workers.updated") {
       startLeaverCheck(account_id, record_id, event_data);
     }
     res.sendStatus(200);
   });

   Your backend Read the docs (opens in a new tab)

   app.yourproduct.com/agent/activity

   Your product Agent activity

   Northwind OverviewAgentActivityIntegrations Settings

   Runs started by eventsTodayLive

   

   Employee record changedSynthetic event

   Kim Novak's employment ended

   now

   Leaver access run RunningDone

   

   Incident createdNative event

   "I can't open Figma"

   12m

   Request agent run Resolved

   

   Team changeNative event

   Ana Ruiz moved to Finance

   1h

   POST/webhooks/stackonenow

   {
     "event": "workday_list_workers.updated",
     "account_id": "northwind-workday",
     "record_id": "kim-novak",
     "event_data": { … }
   }

6. 06 Observe calls In StackOne Every call, logged per customer.

   Every action call lands in the StackOne dashboard's logs, filtered by customer and linked account. To show the same activity in your own product, pull it from the Logs API (opens in a new tab).

   app.stackone.com/logs

   Logs

   Logs

   Action logsEvery call your agents made, per customer.

   Account: NorthwindLast 24 hoursAll connectorsAll statuses

   TimeActionAccountStatusDuration

   14:03 Send Message northwind 200 154 ms

   14:02 Create Time Off Request northwind 200 412 ms

   14:02 Get Worker northwind 200 188 ms

   13:58 Assign User To Application northwind 200 296 ms

   13:41 List Workers northwind 429 97 ms

   13:41 List Workers northwind 200 640 ms

   Create Time Off Request14:02:11

   Status

   200 OK

   Action id

   workday_create_time_off_request

   Linked account

   northwind · Workday

   Duration

   412 ms

   Called by

   Your agent