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.