ramp-submit-reimbursement

Submit out-of-pocket reimbursements from receipts through the Ramp CLI or MCP tools.

2|1|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/ramp-public/skills --skill ramp-submit-reimbursement-ramp-public
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ramp-submit-reimbursement
Source: https://github.com/ramp-public/skills/tree/main/plugins/ramp/skills/ramp-submit-reimbursement
Command: npx skills add https://github.com/ramp-public/skills --skill ramp-submit-reimbursement-ramp-public

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Submitting out-of-pocket expenses in Ramp requires uploading a receipt, creating a draft reimbursement, filling in memos, funds, and accounting categories, and then submitting for approval. This Skill guides an AI agent through that entire multi-step workflow so users can file reimbursements conversationally without navigating the Ramp app. ## Core Features & Use Cases - Receipt Upload & Draft Creation: Base64-encodes receipt files (PNG, JPEG, PDF, HEIC, WEBP), uploads them, and creates a draft reimbursement with AI-suggested memos, funds, and accounting codings. - Guided Field Completion: Reads missing_items from each response and fills required fields (memo, fund, tracking categories) using suggestions or ramp funds list, with support for correcting amounts in the draft's existing currency. - Confirmation & Submission: Presents a full summary (amount, merchant, memo, fund, category, receipt) for user confirmation before submitting for approval, plus resubmission handling for rejected reimbursements. - Use Case: An employee says "I bought coffee for a client meeting, here's the receipt" — the agent uploads the receipt, creates the draft, applies suggested coding, confirms the details, and submits the reimbursement for approval. ## Quick Start Ask your agent to submit a reimbursement by providing a receipt file, for example: "Reimburse me for this expense — the receipt is at ~/Downloads/receipt.pdf."

Frequently Asked Questions about ramp-submit-reimbursement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit a reimbursement in Ramp from a receipt?▼

Upload the base64-encoded receipt with ramp receipts upload, create a draft with ramp reimbursements create using the returned receipt_uuid, fill required fields like memo and fund, then run ramp reimbursements submit after confirming details with the user.

How do I fix missing fields on a Ramp reimbursement draft?▼

Check the missing_items field in the create or edit response. Set memos and funds with ramp reimbursements edit flags, and use --json with tracking_category_selections for accounting categories. Repeat until all missing items are resolved.

What receipt file formats does Ramp reimbursement upload support?▼

Receipts must be base64-encoded and can be PNG, JPEG, PDF, HEIC, or WEBP files. For files over 100KB, write the base64 output to a temp file to avoid shell argument limits.

Why does Ramp reimbursement submit fail with receipt must be specified?▼

This happens when the draft was created via ramp reimbursements duplicate, which does not copy the receipt. The CLI cannot attach a receipt afterward, so create a fresh reimbursement from a newly uploaded receipt instead.

Can I edit the amount on a Ramp reimbursement?▼

Yes, but only while the reimbursement is in DRAFT status. Use --amount with a positive value in major units of the draft's existing currency; the amount edit alone does not change the currency.

When should I not use the reimbursement submission workflow?▼

Do not use it for approving reimbursements (use ramp-approval-dashboard), uploading receipts to card transactions (use ramp-complete-expenses), or canceling approved reimbursements, which requires a manager or the Ramp app.