> ## Documentation Index
> Fetch the complete documentation index at: https://serval-hannah-docs-custom-access.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ramp

## About Ramp

Ramp is a finance automation platform that combines corporate cards with expense management, bill payments, and accounting integrations. Connecting Ramp to Serval enables automated expense workflows, transaction monitoring, and financial reporting directly from your service desk.

## What the Ramp integration enables

| Capability           | Description                                                                       |
| -------------------- | --------------------------------------------------------------------------------- |
| Access Management    | Create, update, and manage users and their permissions within your Ramp account   |
| Automation workflows | Query transactions, manage expense policies, retrieve spending insights, and more |

Anything defined in the [Ramp API](https://docs.ramp.com/developer-api/v1/overview) which uses the available permission scopes can be accessed through Serval.

***

## Ramp Configuration

### Prerequisites

* You must have admin access to your Ramp account (or Sandbox)
* Access to the Developer API section in Settings

### Create a Developer App

1. Navigate to **Settings** → **Developer API** in your Ramp account (or Sandbox)
2. Click **Create New App**
3. Name your app (e.g., "Serval Integration"), accept the Terms, and click **Create**
4. Under **Grant types**, click **Add new grant type** → select **Client Credentials**
5. Under **Scopes**, click **Configure allowed scopes** and select:
   * `users:read` (required for reading user information)
   * `users:write` (required for creating and managing users)
   * Add any additional scopes as needed for your use case
6. Copy your **Client ID** and **Client Secret** - you'll need these for the Serval configuration

***

## Serval Configuration

1. In Serval go to **Apps → Available → Ramp → Connect**

2. Enter the following information:

   | Field         | Description                                                                                                       |
   | ------------- | ----------------------------------------------------------------------------------------------------------------- |
   | Instance ID   | A unique identifier for this integration instance                                                                 |
   | Instance Name | A friendly name for this integration instance                                                                     |
   | Client ID     | The Client ID from your Ramp Developer App                                                                        |
   | Client Secret | The Client Secret from your Ramp Developer App                                                                    |
   | Scopes        | A comma-separated list of scopes to grant to the integration, these must also be enabled in the Ramp Developer UI |

3. Click **Save**

***

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance with your Ramp integration.