> ## Documentation Index > Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt > Use this file to discover all available pages before exploring further. # Ramp > Integration details and setup guide for the Ramp connector in Alloy Automation. ## Pre-Built Tooling | Category | Details | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Authentication** | OAuth 2.0 (Authorization Code with refresh tokens) + Bearer Token | | **Two-Way Sync** | No | | **Events Supported** | No | | **Realtime** | Polling | | **Supports Rate Limiting** | Yes | | **Authentication Scopes Supported** | accounting:read, accounting:write, bills:read, business:read, card\_programs:read, card\_programs:write, cards:read, cards:write, cashbacks:read, departments:read, departments:write, leads:read, leads:write, limits:read, limits:write, locations:read, locations:write, memos:read, merchants:read, receipt\_integrations:read, receipt\_integrations:write, receipts:read, reimbursements:read, spend\_programs:read, spend\_programs:write, statements:read, transactions:read, transfers:read, users:read, users:write | *** ## Objects Supported Alloy Automation supports syncing the following objects from **Ramp**: * **Users** * **Cards** * **Transactions** * **Receipts** * **Departments** * **Reimbursements** * **Bills** * **Accounting** *** ## Set Up Guide ### Trial Access | Question | Answer | | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | **Offers free trial?** | Yes. Ramp offers a demo account for businesses to explore the platform. [Request demo](https://ramp.com/demo) | | **Requires paid sandbox?** | No. However, you need to work with Ramp to get developer sandbox access. | | **Requires partnership to obtain authentication?** | No, but you need to be a Ramp customer or partner to obtain OAuth credentials. | *** ### Authentication (OAuth 2.0) For customers who want to completely whitelabel their OAuth experience, you can provide your own developer keys instead of using Alloy Automation's. Sign up for Ramp at [https://ramp.com](https://ramp.com) or contact their sales team to set up a business account 1. Contact Ramp support or your account manager to request API and developer access 2. Explain your integration use case 3. Request sandbox environment access for testing 1. Once approved, access the Ramp Developer Portal 2. Create a new OAuth application 3. Provide your application name and description 4. Set the redirect URL to: `https://api.runalloy.com/api/strategy/connector/ramp/callback` 5. Select the OAuth scopes your integration needs (see scopes in Pre-Built Tooling section) 6. Note your **Client ID** and **Client Secret** 1. In Alloy Automation, enter your Ramp Client ID and Client Secret 2. Configure the required OAuth scopes for your use case 3. Users will be redirected to Ramp to authorize access 4. Alloy Automation will handle OAuth flow and token refresh automatically For API documentation, visit [Ramp Developer Docs](https://docs.ramp.com/). *** ## Use Cases ### 1) Expense management automation Sync transaction data, receipts, and card spend from Ramp to your accounting system or ERP to automate expense tracking and reconciliation. ### 2) Corporate card provisioning Automatically provision virtual or physical Ramp cards for employees when they're added to your HRIS, and sync card limits and spend controls based on department or role. ### 3) Real-time spend visibility Pull transaction data from Ramp into your financial dashboard or BI platform for real-time visibility into company spending across departments and categories. ### 4) Reimbursement workflow automation Automatically process reimbursement requests from Ramp in your accounting system, matching receipts and approvals for faster employee reimbursements. ### 5) Accounting integration Sync transactions, bills, and accounting data from Ramp to your accounting platform (QuickBooks, NetSuite, etc.) to maintain accurate financial records and simplify month-end close. *** ## API Gotchas * **OAuth scope planning:** Ramp has granular OAuth scopes for read and write access to different resource types. Plan your scope requirements carefully before development to avoid needing to re-authorize users. * **Rate limiting:** The API enforces rate limits to protect system performance. Implement exponential backoff retry logic when you receive rate limit responses. * **Webhook availability:** While the API supports polling, Ramp also offers webhooks for real-time transaction and event notifications. Consider using webhooks for more efficient integrations. * **Business context required:** Most API operations require a business context. Ensure you're properly handling multi-business scenarios if your integration supports users with access to multiple Ramp businesses. * **Receipt matching:** Transactions and receipts are separate objects in Ramp. Implement logic to match receipts to transactions based on amount, date, and merchant for complete expense records. > For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.