> ## Documentation Index
> Fetch the complete documentation index at: https://help.owlery.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Ramp to Owlery

> Set up a Ramp developer app and link it to Owlery so invoice and bill data syncs automatically.

This page is for **Shippers**: teams that quote, tender, and pay for freight in Owlery. If the person you're helping isn't a shipper, this page doesn't apply to them.

Connecting Ramp lets Owlery read and write bill data, pull vendor records, and sync accounting info from your Ramp account. The setup takes about 10 minutes and has two parts: create an app in Ramp, then link it in Owlery.

> [!NOTE]
>
> You'll need **admin access in Ramp** to create a developer app. If you don't see the Developer section in Ramp, ask your Ramp admin to set this up or grant you access.

Ramp also provides an official [guide to building OAuth apps](https://docs.ramp.com/developer-api/v1/guides/building-oauth-apps). Use the steps below for Owlery's required settings and values.

## Part 1: Create Your App in Ramp

**1. Open the Developer section**

In Ramp, scroll down in the left-hand navigation to **Company** and select **Developer**. On the **Apps** tab, click **Create new app**.

![Image](https://mintcdn.com/owlery-6f62edf5/zkN4-JFUd8TcaQ7j/images/image-7.png?fit=max\&auto=format\&n=zkN4-JFUd8TcaQ7j\&q=85\&s=bc740d4e4e03170c638b55413a610ebe)

**2. Name the app**

Enter `Owlery` as the **App name**, accept Ramp's Developer Terms of Service, and click **Create app**.

![Image](https://mintcdn.com/owlery-6f62edf5/zkN4-JFUd8TcaQ7j/images/image-8.png?fit=max\&auto=format\&n=zkN4-JFUd8TcaQ7j\&q=85\&s=dad6876d431822230cf6af267e48c326)

## Part 2: Configure the App

Once the app is created, you'll land on its settings page. Work through each section below.

### Redirect URI

Under **Redirect URIs**, click **+ Add new URI** and add this URL:

```text theme={null}
https://owlery.ai/api/auth/integrations/callback/ramp
```

This tells Ramp where to send you after you authorize the connection.

### Grant Types

Under **Grant types**, enable all three toggles:

* **Authorization code**
* **Client credentials**
* **Refresh token**

All three need to be on for the connection to work.

![Image](https://mintcdn.com/owlery-6f62edf5/zkN4-JFUd8TcaQ7j/images/image-9.png?fit=max\&auto=format\&n=zkN4-JFUd8TcaQ7j\&q=85\&s=90d3a6fe103544b46ff5c4a2e9853f19)

### Scopes

Scroll to **Scopes** and click **Configure allowed scopes**. Add all six of the following before you connect:

| Scope | What Owlery uses it for |
| - | - |
| `bills:write` | Create and update bills from approved invoices |
| `bills:read` | Find existing bills so re-sends don't create duplicates, and read bill status |
| `vendors:read` | Search Ramp vendors for the vendor mapping |
| `entities:read` | Search Ramp entities for the entity mapping |
| `accounting:read` | Look up GL accounts, classes, and the linked accounting system (QuickBooks or NetSuite) |
| `purchase_orders:read` | Match bills to QuickBooks freight POs synced into Ramp |

> [!NOTE]
>
> If you change scopes in Ramp after connecting, approve the connection again. In Owlery, edit the Ramp integration and click **Continue**. Owlery doesn't pick up new scopes on its own.

### Save Your Credentials

After saving the app, Ramp displays a **Client ID** and **Client Secret**. Copy both. You'll need them in the next step.

> [!TIP]
>
> Copy the Client Secret somewhere safe before you leave the page.

## Part 3: Connect in Owlery

**1. Add Ramp as a provider**

In Owlery, go to `Settings → Integrations` and click **+ Integration**. In the search box, type `ramp` and select **Ramp**.

![Image](https://mintcdn.com/owlery-6f62edf5/zkN4-JFUd8TcaQ7j/images/image-10.png?fit=max\&auto=format\&n=zkN4-JFUd8TcaQ7j\&q=85\&s=59d0a44eaeb7c22c2348623849ba2670)

**2. Enter your credentials**

Paste the values from Ramp:

* **Client ID**: from your Ramp app
* **Client Secret**: from your Ramp app
* **API URL**: enter `https://api.ramp.com`

**3. Authorize the connection**

Click **Continue**. You'll be redirected to Ramp to approve Owlery's access. Once you approve, Ramp sends you back to Owlery and the connection is live.

## Next Steps

On the Ramp card, click **Settings** to map vendors, entities, and GL accounts, and to choose when bills are sent. See [Configuration Reference](/shippers/ramp/configuration.md).

## Troubleshooting

> **I don't see the Developer section in Ramp**
>
> The Developer section is only visible to Ramp admins. Ask your Ramp admin to either create the app for you or grant you admin access.

> **The redirect fails or I get an error after approving**
>
> Double-check that the redirect URI in your Ramp app matches exactly: `https://owlery.ai/api/auth/integrations/callback/ramp`. Extra spaces or a missing trailing path segment will break the redirect.

> **Owlery isn't syncing data from Ramp**
>
> Make sure all six scopes above are enabled on your Ramp app. If you changed scopes after connecting, approve the connection again: in Owlery, edit the Ramp integration and click **Continue**, then approve in Ramp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.