Integrating with Ramp

Drivetrain connects to Ramp using OAuth client credentials (a Client ID and Client Secret) generated from a developer app in your Ramp account. To set up this integration, you will create a developer app, enable the Client Credentials grant, assign the required read scopes, and share the credentials with Drivetrain. This guide covers the above-mentioned steps in detail below.

Prerequisites

To connect Ramp to Drivetrain, you need:

• An active Ramp account with Admin access to the Ramp dashboard.

• Permission to create developer apps in Ramp (Company → Developer).

• Admin privileges in Drivetrain.

Ramp Setup

Step 1: Create a developer app

1. Log in to your Ramp account as an Admin.

2. Go to Company → Developer.

3. Click Create New App.

4. Name your app (e.g., "Drivetrain Integration") and accept the Terms.

Step 2: Add the grant type and scopes

1. Under Grant types, click Add new grant type and select Client Credentials.

2. Under Scopes, click Configure allowed scopes and select the read scopes required for Drivetrain.

   • At a minimum, enable transactions:read.

   • Confirm the full list of scopes with your Drivetrain Customer Success Manager or Solutions Consultant, based on the Ramp data you want to sync (for example: transactions, reimbursements, bills, cards, users, and departments).

Note: Drivetrain only reads data from Ramp. Select read scopes (...:read) only — no write scopes are required.

Step 3: Copy your Client ID and Client Secret

1. Copy the Client ID and Client Secret.

2. Store them securely in a document — you will share them with Drivetrain, and the Client Secret is shown only once.

Note: If you lose the Client Secret, you can generate a new one from the app's page in Company → Developer.

Step 4: Note your environment

Identify which Ramp environment you are connecting:

• Production — API base URL: https://api.ramp.com

• Sandbox (demo) — API base URL: https://demo-api.ramp.com

Most integrations use Production unless you are connecting a sandbox for testing.

Drivetrain Setup

Add the Ramp connector

1. Sign in to your Drivetrain instance. Make sure you are logged in as an administrator.

   
2. On the Data page, click + Add Data Source.

3. Select the Ramp Data Connector from the list of integrations.

   
4. Enter the Client ID and Client Secret you generated, then click Submit. (The connector form has two fields — no environment selector.)

   
5. You will be redirected to the Data page where you will be able to see your new Ramp connection.

6. Once the sync is complete, you will be able to see your Ramp data on Drivetrain!

If you have any questions or run into any issues during the integration process, please contact your customer success manager for assistance.