Ramp (Sandbox Version) icon

CONNECT APP

Build with Ramp (Sandbox Version)

The Ramp sandbox is a testing environment where developers and partners can safely build, test, and experiment with Ramp's API without affecting live production data. Access the live version of Ramp here.

Business Management

  • OAuth

MCP

Give your agent Ramp (Sandbox Version) tools

Every Ramp (Sandbox Version) action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Ramp (Sandbox Version) account for each tool call — you store no tokens.

// 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()

// e.g. run Create Department:
const result = await mcp.callTool({
  name: "ramp_sandbox-create-department",
  arguments: {
    name: "Name",
  },
})

API PROXY

Call the Ramp (Sandbox Version) API directly

For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Ramp (Sandbox Version) API with the connected user's credentials attached. You store no tokens and write no refresh logic.

const resp = await pd.proxy.get({
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  accountId: "apn_xxxxxxx",
  url: "https://demo-api.ramp.com/developer/v1/business",
})

// Any allowed Ramp (Sandbox Version) endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.

SDK

Run Ramp (Sandbox Version) actions from your backend

Connect a user's Ramp (Sandbox Version) account once, then run Create Department on their behalf from your own code — TypeScript, Python, or plain HTTP.

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-create-department",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ramp_sandbox: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
  },
})

TOOLS

Ramp (Sandbox Version) actions

On-demand operations your product or agent can configure and run on behalf of a connected user.

MULTI-APP

Use Ramp (Sandbox Version) with other popular apps

Most products don't stop at one integration. Pair Ramp (Sandbox Version) with the other apps your users rely on, and ship use cases that span both.

REFERENCE

App details

Reference metadata for the Ramp (Sandbox Version) connector in the Pipedream registry.

App slug
ramp_sandbox
Authentication
OAuth
Categories
Business Management
Actions
18
Triggers
3
API proxy
Available

OAuth scopes

These are the scopes Pipedream's managed Ramp (Sandbox Version) OAuth client requests when one of your users connects an account. Supply your own OAuth client to request a different set.

  • transactions:read
  • cards:read
  • cards:write
  • spend_programs:read
  • spend_programs:write
  • users:read
  • users:write
  • locations:read
  • locations:write
  • limits:read
  • limits:write
  • departments:read
  • departments:write
  • business:read
  • receipts:read
  • transfers:read
  • vendors:read
  • merchants:read
  • accounting:read
  • accounting:write
  • receipts:write
  • reimbursements:read
  • funds:read
  • funds:write