> For the complete documentation index, see [llms.txt](https://integrations.drivetrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/accounting-and-erp/integrating-with-ramp.md).

# 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).

{% hint style="info" %}
**Note:** Drivetrain only reads data from Ramp. Select read scopes (`...:read`) only — no write scopes are required.
{% endhint %}

#### 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**.

{% hint style="info" %}
**Note:** If you lose the Client Secret, you can generate a new one from the app's page in **Company → Developer**.
{% endhint %}

#### 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.<br>

   <figure><img src="/files/1RPIIkn0Q9ix0HoN5t0e" alt=""><figcaption></figcaption></figure>
2. On the **Data** page, click **+ Add Data Source**.
3. Select the **Ramp** Data Connector from the list of integrations.<br>

   <figure><img src="/files/GgPH7bLXgrJnKnrGOXYX" alt=""><figcaption></figcaption></figure>
4. Enter the Client ID and Client Secret you generated, then click Submit. (The connector form has two fields — no environment selector.)<br>

   <figure><img src="/files/eIvw3bC0FdHk1RmWlb6u" alt=""><figcaption></figcaption></figure>
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!

{% hint style="info" %}
If you have any questions or run into any issues during the integration process, please contact your customer success manager for assistance.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/accounting-and-erp/integrating-with-ramp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.