New Integration: Ramp

Description

Add Ramp integration to sync corporate card transactions, expense data, reimbursements, and card management into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/hubspot/ - Similar business data system
• integrations/linear/ - Project management integration
• integrations/slack/ - For reference

Required Files Structure

integrations/ramp/
├── src/
│   ├── index.ts          # Main entry, OAuth spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # Ramp API utilities
│   ├── account-create.ts # OAuth setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

Ramp API Integration

OAuth Setup

• Use OAuth 2.0 authorization
• Create a developer app in Settings > Developer to obtain API credentials (requires admin access)
• OpenAPI spec available at: https://docs.ramp.com/openapi/developer-api.json
• Base documentation: https://docs.ramp.com/

Key Endpoints

• GET /transactions - List transactions
• GET /cards - List cards
• GET /users - List users
• GET /reimbursements - List reimbursements
• GET /receipts - List receipts
• GET /departments - List departments
• GET /locations - List locations
• GET /vendors - List vendors
• GET /accounting/connections - Accounting connections

Events to Track

1. Transactions - New card transactions, transaction updates, merchant categorization
2. Expenses - Expense submitted, receipt uploaded, memo added
3. Reimbursements - Reimbursement requested, approved, paid
4. Cards - Card issued, card locked, card terminated, limit changed
5. Users - User invited, user activated, role changed

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement OAuth 2.0 flow in account-create.ts
• Create API utilities in utils.ts for Ramp API calls
• Implement sync logic in schedule.ts for transactions, cards, and users
• Convert expense events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• Machine-readable OpenAPI spec available for code generation
• Developer Assist (AI-powered) is built into the docs for real-time help
• Support available at developer-support@ramp.com for API issues
• Plain text docs available at https://docs.ramp.com/llms.txt

Resources

• Ramp API Documentation
• Ramp Developer Tools
• Ramp Technology Partnerships
• Accessing the Developer API

Labels

enhancement, integration, new-feature

Start by comparing integrations/github/src/index.ts with integrations/hubspot/, integrations/linear/, and integrations/slack/. Then review the Ramp OpenAPI specification and map the required work across integrations/ramp/src/index.ts, schedule.ts, utils.ts, account-create.ts, and create-activity.ts. Done means OAuth, transaction/card/user sync, activity formatting, error handling, documentation, and the integrations README entry are complete.