# Ramp

> Ramp corporate cards and spend management - cards, transactions, budgets, expenses, and approvals.

Lets an agent work with your Ramp corporate cards and spend management - read transactions, manage budgets and cardholders, and review or approve expenses.

## What it can do

| Method | What it does |
| --- | --- |
| `ramp_me` | Get the authenticated user profile. |
| `ramp_list_cards` | List corporate cards. |
| `ramp_get_card` | Get one card by id. |
| `ramp_list_transactions` | List transactions; filter by date range, card, user, or status. |
| `ramp_get_transaction` | Get one transaction by id. |
| `ramp_list_budgets` | List budgets. |
| `ramp_get_budget` | Get one budget by id. |
| `ramp_create_budget` | Create a budget with a name and spend limit. |
| `ramp_update_budget` | Update a budget's name, limit, or period. |
| `ramp_delete_budget` | Delete a budget. |
| `ramp_list_users` | List users. |
| `ramp_get_user` | Get one user by id. |
| `ramp_list_merchants` | List merchants; optional name search. |
| `ramp_list_receipts` | List receipts; optional filter by transaction. |
| `ramp_upload_receipt` | Upload a receipt and attach it to a transaction. |
| `ramp_list_teams` | List teams. |
| `ramp_get_team` | Get one team by id. |
| `ramp_list_vendors` | List vendors; optional name search. |
| `ramp_get_vendor` | Get one vendor by id. |
| `ramp_list_card_holders` | List cardholders; optional filter by status. |
| `ramp_get_cardholder` | Get one cardholder by id. |
| `ramp_create_cardholder` | Create a cardholder. |
| `ramp_list_expenses` | List expenses; filter by status or user. |
| `ramp_get_expense` | Get one expense by id. |
| `ramp_update_expense` | Update an expense's category, notes, or tags. |
| `ramp_list_approvals` | List pending approvals; optional filter by status. |
| `ramp_approve_expense` | Approve or reject an expense. |

## How to get credentials

Ramp uses an OAuth client (client ID + client secret) for machine-to-machine access.

1. Open [app.ramp.com/settings/business/developer](https://app.ramp.com/settings/business/developer).
2. Create a new app (OAuth client) under Developer API.
3. Copy the **client ID**.
4. Copy the **client secret** - it is shown only once, when you create the API client.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `RAMP_CLIENT_ID` | Ramp -> Settings -> Developer API -> create app (OAuth client) |
| `RAMP_CLIENT_SECRET` | Shown when you create the API client in Ramp |