> 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/readme/accounting-and-erp/integrating-with-ramp.md).

# Integrating with Ramp

Connect Ramp to Drivetrain using OAuth client credentials. This guide covers creating a developer app, setting read scopes, and syncing transactions.

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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-b21065d51619b785e6371583716c0710415cd552%2Fimage%20-%202026-07-01T162828.161.png?alt=media" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-726fc3cbd9903614aa3e55dcdaa840905dc88a5a%2Fimage%20-%202026-07-04T105918.028.png?alt=media" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fgit-blob-432e4a8ddeb46f0b68040eafbbf600e6d150410a%2Fimage%20-%202026-07-04T110000.919.png?alt=media" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.