Ramp

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

Set these per environment. See Connect an integration.

Variable	Required	Description
`RAMP_CLIENT_ID`	Yes	Ramp developer app Client ID (Ramp dashboard → Company → Developer) Docs.
`RAMP_CLIENT_SECRET`	Yes	Ramp developer app Client Secret Docs.

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.

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

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.