Ramp
Org-level connection
Ramp is connected once at the org level by an admin. The credential is shared across all groups that have been granted access — individual team members don't need to connect their own accounts.
How to connect
Log in to your Ramp account at app.ramp.com
Go to Settings → Developer → Create New App
Set the redirect URI to: https://app.onbelay.ai/api/oauth-callback/ramp
Enable Authorization Code grant type
Copy your Client ID and Client Secret
Paste them into the fields above, then click Connect with OAuth
Ready to connect?
Go directly to the integrations page in your dashboard.
Permissions (scopes)
These are the data scopes On Belay can be granted for Ramp. Your org admin controls which scopes are enabled per group.
| Scope | Description | Access |
|---|---|---|
accounting:read | Read accounting data | Read only |
accounting:write | Write accounting data | Read / Write |
ai_usage:write | Manage AI usage | Read / Write |
attendee_types:read | Read attendee types | Read only |
attendee_types:write | Manage attendee types | Read / Write |
audit_logs:read | Read audit logs | Read only |
bank_accounts:read | Read bank accounts | Read only |
bank_feeds:read | Read bank feeds | Read only |
bills:read | Read bills | Read only |
bills:write | Manage bills | Read / Write |
business:read | Read business info | Read only |
cards:read | Read cards | Read only |
cards:write | Manage cards | Read / Write |
cashbacks:read | Read cashbacks | Read only |
comments:write | Post comments | Read / Write |
custom_records:read | Read custom records | Read only |
custom_records:write | Manage custom records | Read / Write |
departments:read | Read departments | Read only |
departments:write | Manage departments | Read / Write |
embedded_cards:write | Manage embedded cards | Read / Write |
entities:read | Read entities | Read only |
external_attendees:read | Read external attendees | Read only |
external_attendees:write | Manage external attendees | Read / Write |
funds:read | Read funds | Read only |
funds:write | Manage funds | Read / Write |
item_receipts:read | Read item receipts | Read only |
item_receipts:write | Manage item receipts | Read / Write |
limits:read | Read spending limits | Read only |
limits:write | Manage spending limits | Read / Write |
locations:read | Read locations | Read only |
locations:write | Manage locations | Read / Write |
memos:read | Read memos | Read only |
memos:write | Manage memos | Read / Write |
merchants:read | Read merchants | Read only |
offline_access | Offline access (refresh tokens) | Read only |
purchase_orders:read | Read purchase orders | Read only |
purchase_orders:write | Manage purchase orders | Read / Write |
receipt_integrations:read | Read receipt integrations | Read only |
receipt_integrations:write | Manage receipt integrations | Read / Write |
receipts:read | Read receipts | Read only |
receipts:write | Manage receipts | Read / Write |
reimbursements:read | Read reimbursements | Read only |
reimbursements:write | Manage reimbursements | Read / Write |
repayments:read | Read repayments | Read only |
spend_programs:read | Read spend programs | Read only |
spend_programs:write | Manage spend programs | Read / Write |
statements:read | Read statements | Read only |
transactions:read | Read transactions | Read only |
transfers:read | Read transfers | Read only |
treasury:read | Read treasury data | Read only |
trips:read | Read trips | Read only |
users:read | Read users | Read only |
users:write | Manage users | Read / Write |
vendors:read | Read vendors | Read only |
vendors:write | Manage vendors | Read / Write |
Troubleshooting
"redirect_uri_mismatch" error during OAuth
Your OAuth app's authorized redirect URIs don't include the On Belay callback URL. Add https://app.onbelay.ai/api/oauth-callback/ramp to the allowed redirect URIs in your OAuth app settings.
"invalid_scope" error
The API or scope isn't enabled in your cloud project. For Google integrations, make sure the relevant API (e.g., Google Ads API, Search Console API) is enabled in Google Cloud Console for your project.
Connected but Claude can't access data
Check that your group has been granted access to this integration in On Belay → Groups → [your group] → Integrations. Also verify the specific scopes your group is permitted to use match what your query requires.
Still stuck? We're happy to help.
Contact support →