# Rydoo — Pipedream Connect

> Smart Expense Management

- API slug: `rydoo` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Business Management
- Website: https://www.rydoo.com
- Managed OAuth scopes: `company` · `structure:read` · `structure:write` · `expenses:read` · `expenses:write` · `fields:read` · `fields:write` · `users:read` · `users:write`
- This page (HTML): https://pipedream.com/apps/rydoo
- Tools: 17 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: rydoo`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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": "rydoo",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add New User:
const result = await mcp.callTool({
  name: "rydoo-add-new-user",
  arguments: {
    email: "Email",
    firstName: "First Name",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Rydoo endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.rydoo.com/v2/users

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkucnlkb28uY29tL3YyL3VzZXJz?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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: "rydoo-add-new-user",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    rydoo: { authProvisionId: "apn_xxxxxxx" },
    email: "Email",
    firstName: "First Name",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (17)

### `rydoo-add-new-user` — Add New User (Write)

Creates a new employee record in the company directory. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/add-new-user.md

### `rydoo-create-bank-transaction` — Create Bank Transaction (Write)

Manually pushes a bank transaction record for a specific user. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/create-bank-transaction.md

### `rydoo-create-expense` — Create Expense (Write)

Adds a new expense entry for a user. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/create-expense.md

### `rydoo-create-project` — Create Project (Write)

Sets up a new company project for expense allocation. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/create-project.md

### `rydoo-create-trip` — Create Trip (Write)

Registers a new business trip for a specific user. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/create-trip.md

### `rydoo-export-expenses` — Export Expenses (Read-only)

Retrieves a list of expenses that have been exported, with optional filtering by date range, user, group, trip, or branch. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/export-expenses.md

### `rydoo-find-group` — Find Group (Read-only)

Searches for organizational groups by name to find their UUIDs. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/find-group.md

### `rydoo-get-user-details` — Get User Details (Read-only)

Retrieves full profile information, roles, and modules for a specific user. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/get-user-details.md

### `rydoo-reject-expenses` — Reject Expenses (Write)

Denies a set of expenses with a specific rejection reason and message. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/reject-expenses.md

### `rydoo-search-branches` — Search Branches (Read-only)

Finds branches by name, ID, or active status. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/search-branches.md

### `rydoo-search-payment-methods` — Search Payment Methods (Read-only)

Finds payment methods by type, branch, card type, status, and more. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/search-payment-methods.md

### `rydoo-search-projects` — Search Projects (Read-only)

Finds active projects by name or reference ID. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/search-projects.md

### `rydoo-search-trips` — Search Trips (Read-only)

Finds trips by user, status, or name. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/search-trips.md

### `rydoo-search-user` — Search User (Read-only)

Searches for users by email, first name, last name, free-text, card status, or external ID. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/search-user.md

### `rydoo-set-expense-to-reimbursed` — Set Expense to Reimbursed (Write)

Sets an expense as reimbursed. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/set-expense-to-reimbursed.md

### `rydoo-update-expense-status-to-reported` — Update Expense Status to Reported (Write)

Marks an individual expense as included in a report. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/update-expense-status-to-reported.md

### `rydoo-update-user-profile` — Update User Profile (Write)

Modifies existing user details like names, nationality, or status. See the documentation

Full schema: https://pipedream.com/apps/rydoo/actions/update-user-profile.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt