Ramp (Sandbox Version) ACTION
Update User
Update fields on an existing Ramp Sandbox user (role, department, location, direct manager). Run the List Users action to find the user ID, List Departments and List Locations for related IDs. Example: to move a user into a department, pass their User ID plus a Department ID from List Departments; you can also set
role (e.g. BUSINESS_USER), location, or direct manager. See the documentation- Action
- Writes data
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Ramp (Sandbox Version) account once, then configure and run Update User from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "ramp_sandbox-update-user",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
ramp_sandbox: { authProvisionId: "apn_xxxxxxx" },
userId: "User ID",
role: "Role",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "ramp_sandbox-update-user",
"configured_props": {
"ramp_sandbox": { "authProvisionId": "apn_xxxxxxx" },
"userId": "User ID",
"role": "Role"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "ramp_sandbox",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "ramp_sandbox-update-user",
arguments: {
userId: "User ID",
role: "Role",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
userId User ID | string | The ID of the user to update — a UUID, e.g. bcc1e4ca-d38a-4cc9-98fc-e6c2066ad0ae. Run the List Users action to find this value. Required |
role Role | string | New role for the user. Optional |
departmentId Department ID | string | New department ID — a UUID, e.g. fffe6c22-698f-4dc5-b2b1-b35f86947d90. Run the List Departments action to find valid IDs. Optional |
locationId Location ID | string | New location ID — a UUID, e.g. 961c6f01-5719-4f4c-8fef-4096a031f32a. Run the List Locations action to find valid IDs. Optional |
directManagerId Direct Manager ID | string | New direct manager user ID — a UUID, e.g. bcc1e4ca-d38a-4cc9-98fc-e6c2066ad0ae. Run the List Users action to find valid IDs. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- ramp_sandbox-update-user
- Version
- 0.0.2
- App
- Ramp (Sandbox Version)
- Authentication
- OAuth
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗