Set up Ramp's Gmail integration

Overview

With Ramp’s Gmail integration, Ramp automatically collects, verifies, and matches your receipts to the correct expense directly from your inbox. After we collect your receipts, Ramp can accurately code, categorize, and map thousands of transactions and then reliably sync them to your accounting provider.

The integration enables a 100% touchless expense reporting process – increasing employee productivity and freeing finance teams to focus on more strategic work. We’ve seen companies automate most of their receipt submission, saving countless hours for the finance teams and employees.

Ramp’s Gmail Integration is easy to install and secure. Our email processing is isolated from our core application: we've strictly limited access, avoid pulling data we don't need, and delete data when it is no longer used.

For IT & Security teams: read the full security brief, which explains how your data is protected→

Jump to:

• Overview
• Important Information
• Limitations
• How does it work?
• Set up
• Opting out inboxes
• Disabling the integration
• Security

Important Information:

• Admins set up Gmail Integration at the company level (employees don't set it up individually). Contact your company's administrator for assistance!
• The integration is currently offered only to users based in the United States.
• The integration picks up PDFs, including invoice PDFs, and does not show itemized details.
• The integration will only match receipts to cleared transactions.
• The integration doesn't read across the whole company. For example, the transaction associated with user A will primarily look for the receipt within user A's inbox.
• Once the integration is set up, it will attach receipts for cleared transactions from the past seven days and going forward.
• Only a single domain / single company account may be linked at a time. If your company is Multi-Entity, admins must link Gmail accounts to their other entity Ramp accounts. A single Ramp instance does not support more than one Gmail integration at a time.

Limitations

• Not compatible with AWS GovCloud (US)

How does it work?

Setup

Ramp’s Gmail integration takes 4 clicks to set up.

Step 1:

Open your Google Admin Console and navigate to Security → API Controls → Domain-wide Delegation.

Here’s a link to take you directly there:

Step 2:

Under API Clients, click “Add New,” enter the details below, and click “Authorize.”

• Client ID: 109090279987290732904
• Auth Scope: https://www.googleapis.com/auth/gmail.readonly

Step 3 (Final step):

Go back to Ramp’s settings and click “initiate connection.” The system will start to enroll your employees automatically and capture receipts.  

Opting out inboxes

The Ramp email integrations give you control of which inboxes we access. By default, Ramp queries only those inboxes that have an associated active Ramp account. We never attempt to access inboxes that do not have a corresponding Ramp user.

Additionally, you can opt out of specific email addresses that do have an associated Ramp accounting using Ramp's developer API (docs) or by sending a request via the support form after you have connected your integration. Please note we will not be able to opt emails out until the integration is connected.

If an employee has multiple email aliases, opting out of their primary email address will also opt out of their aliases. When you opt out of a specific address, our email integration system continues to interact with Google and Microsoft's APIs to list email aliases, but we never attempt to pull email metadata or bodies for messages in that address's inbox. You can see a list of email addresses that have been opted out on the integration configuration page.

How do I disable Ramp’s Gmail integration?

In the Google Admin Console → Domain Wide Delegation, you can remove the API client. This will disable Ramp from accessing any further information, and you’ll see this reflected in the Ramp dashboard shortly thereafter.

Security

By enabling this integration, you are trusting Ramp to have access to your business’s emails. We take this trust extremely seriously and have additional measures in place to secure our Gmail integration. Read the full security brief, which explains how your data is protected→.