At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0 (client credentials).
- Connection: Veryfront mints machine-to-machine tokens from the client ID and secret in the project’s environment variables.
- Docs: https://docs.ramp.com/developer-api/v1/authorization
Credentials
Set these per environment. See Connect an integration.Setup
- Get a Ramp account or sandbox: Sign up at https://ramp.com, or request Sandbox access from Ramp to build without a live account. The sandbox has the same API surface with test data: app at https://demo.ramp.com, API at https://demo-api.ramp.com.
- Create a developer app: In the Ramp dashboard go to Company → Developer (admin access required) and click Create New App. Copy the Client ID and Client Secret.
- Enable the Client Credentials grant and scopes: In the app settings, under Grant types add Client Credentials, then under Scopes configure the allowed scopes: transactions:read, cards:read, users:read, reimbursements:read.
- Set environment variables: Add RAMP_CLIENT_ID and RAMP_CLIENT_SECRET to your .env.
- Verify access: Run List Transactions. Access tokens are minted automatically from https://api.ramp.com/developer/v1/token using HTTP Basic auth with your client credentials; the requested scopes are sent in the token request.
- Sandbox and production require separate apps - create one app in each environment. This connector targets production (api.ramp.com); for sandbox testing point a copy at demo-api.ramp.com with sandbox app credentials.
- Scopes are configured on the app and requested at token time; only request the scopes you need.
- List endpoints paginate with a page.next cursor - pass the last item’s ID as the start parameter for the next page.
Tools
| Tool | Access | Description |
|---|---|---|
| List Transactions | Read | List card transactions with optional filtering by state, user, card, or date window |
| Get Transaction | Read | Fetch full details of a single card transaction |
| List Cards | Read | List corporate cards with optional filtering by owner or activation state |
| List Users | Read | List employees on the Ramp account with optional filtering by email, role, department, or status |
| Get User | Read | Fetch a single employee by ID, e.g. to resolve the user_id referenced on a transaction or card |
| Get Card | Read | Fetch a single corporate card by ID, e.g. to resolve the card_id referenced on a transaction |
| List Reimbursements | Read | List employee reimbursements with optional filtering by user, state, or date window |
Example prompts
- List my recent Ramp card transactions and summarize spend by merchant and category.
- Show Ramp reimbursements that are still pending and who submitted them.
- List all active Ramp cards and their cardholders.