RPC/HTTP - Stackone

You don’t need an agent to use a connector. Any backend, script, or workflow can call an action directly — over the Actions API or with the SDK used standalone.

Calling actions

Make an RPC call to any enabled action with the same two values every protocol and SDK uses: your StackOne API key and the end-user’s x-account-id. The RPC endpoint routes the request to that account’s provider, handles authentication, transforms the request to match the provider API, and returns normalized data. If you don’t already know which action you need, discover what’s available with GET /actions first, then call it with POST /actions/rpc:

cURL
Python
TypeScript SDK
Agent SDK

Authenticate with your API key as Basic auth, and pass the linked account’s ID in the x-account-id header.

Discover available actions

curl "https://api.stackone.com/actions?filter[connectors]=bamboohr" \
  -u "$STACKONE_API_KEY:"

Call the action

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": "bamboohr_list_employees",
    "query": { "page_size": 25 }
  }'

Call the endpoints directly with the requests library — install it with pip install requests.

Discover available actions

import requests
import base64
import os

api_key = os.environ["STACKONE_API_KEY"]
headers = {
    "Authorization": f"Basic {base64.b64encode(f'{api_key}:'.encode()).decode()}"
}

response = requests.get(
    "https://api.stackone.com/actions",
    params={"filter[connectors]": "bamboohr"},
    headers=headers
)

providers = response.json()["data"]

Call the action

import requests
import base64
import os

api_key = os.environ["STACKONE_API_KEY"]
headers = {
    "Authorization": f"Basic {base64.b64encode(f'{api_key}:'.encode()).decode()}",
    "x-account-id": "your-account-id",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.stackone.com/actions/rpc",
    headers=headers,
    json={
        "action": "bamboohr_list_employees",
        "query": {"page_size": 25}
    }
)

employees = response.json()["data"]

Install the platform API client with npm install @stackone/stackone-client-ts (npm, GitHub). Clients for other languages are listed under API SDKs.

Discover available actions

import { StackOne } from "@stackone/stackone-client-ts";

const stackOne = new StackOne({
  security: {
    username: process.env.STACKONE_API_KEY!,
    password: "",
  },
});

const result = await stackOne.actions.listActionsMeta({
  filter: {
    connectors: "bamboohr",  // Filter by provider
  },
});

const actions = result.actionsMetaPaginated?.data?.[0]?.actions ?? [];

// actions = [
//   { id: "bamboohr_list_employees", label: "List Employees", ... },
//   { id: "bamboohr_get_employee", label: "Get Employee", ... },
//   ...
// ]

Call the action

const result = await stackOne.actions.rpcAction({
  action: "bamboohr_list_employees",
  query: {
    pageSize: "25",
  },
  xAccountId: "your-account-id",
});

// result.rpcActionResponse?.data = [{ id: "emp_123", ... }, ...]

Install the Agent SDK with npm install @stackone/ai (npm, GitHub) — see Agent SDK for the full guides. It runs without a framework: fetch a tool and execute it yourself, no LLM in the loop.

Discover available actions

import { StackOneToolSet } from '@stackone/ai';

const toolset = new StackOneToolSet();
const tools = await toolset.fetchTools({ accountIds: ['your-account-id'] });

Call the action

const result = await tools.getTool('bamboohr_list_employees').execute();

POST actions/rpc request parameters

Parameter	Type	Description
`action`	string	The action identifier (e.g., `bamboohr_list_employees`, `greenhouse_create_candidate`)
`query`	object	Query parameters for the action
`body`	object	Request body for write operations
`path`	object	Path parameters (e.g., `{ "id": "emp_123" }`)

Common action patterns

Query parameters — Workday: list employees

const result = await stackOne.actions.rpcAction({
  action: "workday_list_employees",
  query: { pageSize: "50" },
  xAccountId: "your-account-id",
});

Request body — Greenhouse: create candidate

const result = await stackOne.actions.rpcAction({
  action: "greenhouse_create_candidate",
  body: {
    first_name: "Jane",
    last_name: "Doe",
    email: "jane@example.com"
  },
  xAccountId: "your-account-id",
});

Path parameters — Salesforce: get contact

const result = await stackOne.actions.rpcAction({
  action: "salesforce_get_contact",
  path: { id: "contact_abc123" },
  xAccountId: "your-account-id",
});

GET /actions

API reference for actions metadata.

POST /actions/rpc

API reference for the RPC endpoint.

When to use this

Syncing or enriching data in a backend job
Triggering an action from your own app logic
Scripting one-off tasks against a provider

For agent-driven use:

MCP

Open standard for AI tools. Works with Claude, Cursor, Vercel AI, n8n

Agent SDK

Native TypeScript/Python with framework integrations (LangChain, CrewAI, OpenAI)

A2A

Call a pre-built agent per integration — for multi-agent orchestration.

​Calling actions

​Discover available actions

​Call the action

​Discover available actions

​Call the action

​Discover available actions

​Call the action

​Discover available actions

​Call the action

​POST actions/rpc request parameters

GET /actions

POST /actions/rpc

​When to use this

MCP

Agent SDK

A2A

Calling actions

Discover available actions

Call the action

Discover available actions

Call the action

Discover available actions

Call the action

Discover available actions

Call the action

POST actions/rpc request parameters

When to use this