- Category: accounting
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 111
- Triggers: 0
- Slug:
RAMP - Version: 20261101_00
Tools
Add Purchase Order Line Items
Add Purchase Order Line Items
Add Receipt Integration Opt Out Email
Add Receipt Integration Opt Out Email
RAMP_ADD_RECEIPT_INTEGRATION_OPT_OUT_EMAILAdd an email to a business’s receipt integrations opt-out list. Requires an email address; business_id is optional for the connected business. Returns the created opt-out object’s email and UUID when present. The provider may return a null UUID; list opt-outs to discover it before removal. Requires receipt_integrations:write.Input Parameters
Output
Archive Bill
Archive Bill
Archive Purchase Order
Archive Purchase Order
Archive Vendor Bank Account
Archive Vendor Bank Account
RAMP_ARCHIVE_VENDOR_BANK_ACCOUNTArchive a vendor bank account by vendor ID and bank account ID. If the account has associated bills, drafts, or recurring templates, provide replacement_bank_account_id to transfer them to a replacement account. Returns a local success acknowledgement for HTTP 204; does not initiate a payment.Input Parameters
Output
Create Accounting Field Option Filter Rules
Create Accounting Field Option Filter Rules
RAMP_CREATE_ACCOUNTING_FIELD_OPTION_FILTER_RULESCreate accounting field option filter rules in bulk. Requires Ramp Plus. Rules restrict target options based on trigger field selections: AND within each rule, OR between rules for the same target option. Existing rules count as duplicates without changes. Returns created and duplicate counts.Input Parameters
Output
Create Bill
Create Bill
RAMP_CREATE_BILLCreate a Ramp bill. Ramp does not support creating batch payments through this API.Input Parameters
Output
Create Card Embed Token
Create Card Embed Token
RAMP_CREATE_CARD_EMBED_TOKENCreate an embed initialization token for an activated, currently active card. Use the returned token to initialize Ramp Embedded and exchange it for a session token. Requires Embedded Cards access; this does not activate or issue a card.Input Parameters
Output
Create Card Vault
Create Card Vault
RAMP_CREATE_CARD_VAULTCreate a spend limit and virtual card synchronously, returning sensitive card details. Requires Vault API access (production requires Ramp approval). Uses the separate vault host. PAN and CVV must only be used transiently, never logged or persisted. To terminate this fund-backed card, DELETE /developer/v1/funds/{spend_limit_id} with funds:write; this irreversibly terminates the fund and its attached cards.Input Parameters
Output
Create Department
Create Department
Create Draft Bill (Beta)
Create Draft Bill (Beta)
RAMP_CREATE_DRAFT_BILLBeta: create a Ramp draft bill for a vendor without submitting it.Input Parameters
Output
Create Draft Spend Request Via OCR
Create Draft Spend Request Via OCR
RAMP_CREATE_DRAFT_SPEND_REQUEST_VIA_OCRCreate a draft spend request by extracting information from an uploaded document. Requires Ramp Plus and a requester and spend program. Returns the draft ID; this operation does not submit the draft for approval. Reuse the idempotency key when retrying the same request.Input Parameters
Output
Create Inventory Item Accounting Field
Create Inventory Item Accounting Field
RAMP_CREATE_INVENTORY_ITEM_ACCOUNTING_FIELDTool to create a new inventory item accounting field for tracking inventory categories. Use when setting up inventory tracking for an accounting connection. Note: There can only be one active inventory item accounting field per accounting connection.Input Parameters
Output
Create Item Receipt
Create Item Receipt
RAMP_CREATE_ITEM_RECEIPTCreate an item receipt for purchase order lines. Requires Ramp Plus. Records goods or services as received; expense lines may be received in full regardless of unit_quantity (see that field). Returns the created receipt and typed line items. This endpoint does not accept files or document uploads.Input Parameters
Output
Create Location
Create Location
RAMP_CREATE_LOCATIONCreate a named location in the Ramp organization, optionally under a business entity. Returns the location ID, name, and associated entity ID. This creates an organizational location, not a shipping address or payment recipient.Input Parameters
Output
Create Transaction Memo
Create Transaction Memo
Create Mileage Reimbursement
Create Mileage Reimbursement
RAMP_CREATE_MILEAGE_REIMBURSEMENTTool to create a mileage reimbursement in Ramp. Use when a user needs to submit a reimbursement for business-related travel distance. Requires distance, reimbursee_id, and trip_date as mandatory fields.Input Parameters
Output
Create Mock Webhook Event
Create Mock Webhook Event
RAMP_CREATE_MOCK_WEBHOOK_EVENTCreate a mock webhook event for active subscriptions matching its event type. Use to exercise webhook delivery with a supplied object UUID and metadata. This sends to every matching active subscription; it does not target a single subscription or create a business object.Input Parameters
Output
Create New Custom Accounting Field
Create New Custom Accounting Field
RAMP_CREATE_NEW_CUSTOM_ACCOUNTING_FIELDTool for creating a new custom accounting field. Note: This operation requires elevated permissions not available in the demo API.Input Parameters
Output
Create Procurement Request
Create Procurement Request
RAMP_CREATE_PROCUREMENT_REQUESTCreate a procurement request for a purchase-order or approval-only spend program. Early access must be enabled for the business, with a business-scoped token and Ramp Plus. By default this submits into the program’s approval flow; set submit=false for a draft. File-upload form fields are unsupported and required unanswered fields are reported in additional_info.fields_to_answer. A new vendor contact is saved even for a draft. Returns request detail.Input Parameters
Output
Create Purchase Order
Create Purchase Order
RAMP_CREATE_PURCHASE_ORDERCreate a purchase order. Purchase Orders require a Ramp Plus account.Input Parameters
Output
Create Spend Program
Create Spend Program
RAMP_CREATE_SPEND_PROGRAMCreate a Ramp spend program with spending limits and optional issuance rules. Automatic issuance can assign limits to matching users; physical-card issuance is disabled by default. This API does not expose a spend-program delete operation.Input Parameters
Output
Create Tax Code Accounting Field
Create Tax Code Accounting Field
RAMP_CREATE_TAX_CODE_ACCOUNTING_FIELDTool to create a new tax code accounting field in Ramp. There can only be one active tax code accounting field per accounting connection. Use when you need to set up tax code tracking for an accounting integration.Input Parameters
Output
Create User Invite
Create User Invite
RAMP_CREATE_USER_INVITETool to create a user invite for onboarding new employees to Ramp. Triggers an async task to send an invite email. Users must accept the invite to be onboarded. Assign users to specific entities using location_id.Input Parameters
Output
Create Vendor
Create Vendor
RAMP_CREATE_VENDORCreate an approved Ramp vendor, bypassing existing vendor approval policies. Optionally request payment or tax details from a contact. These flags default to false. Admin/owner tokens may choose requesting_user_id for those requests.Input Parameters
Output
Create Vendor Contact
Create Vendor Contact
Create Webhook Subscription
Create Webhook Subscription
RAMP_CREATE_WEBHOOK_SUBSCRIPTIONTool to create a new webhook subscription for receiving event notifications from Ramp. Use when you need to set up real-time notifications for events like transactions, bills, or reimbursements. The newly registered subscription will be in pending verification state and requires endpoint verification with the provided challenge.Input Parameters
Output
Deactivate User
Deactivate User
Delete Accounting GL Account
Delete Accounting GL Account
Delete Accounting Connection
Delete Accounting Connection
RAMP_DELETE_ACCOUNTING_CONNECTIONTool to disconnect the current active API-based accounting connection. Use when you need to disable the accounting integration. This action will clear associated accounting settings including Custom Fields, GL Accounts, and Vendors. Only API-based connections can be disconnected via this endpoint.Output
Delete Accounting Field Option Filter Rules
Delete Accounting Field Option Filter Rules
RAMP_DELETE_ACCOUNTING_FIELD_OPTION_FILTER_RULESBulk delete specific accounting field option filter rules (Ramp Plus required). Identify each rule by its target field and option remote IDs plus its required trigger selections. Missing rules are no-ops, reported in not_found_count. Returns deleted and missing rule counts; does not delete fields or options.Input Parameters
Output
Delete Custom Accounting Field
Delete Custom Accounting Field
Delete Accounting Inventory Item Option
Delete Accounting Inventory Item Option
Delete Tax Code Accounting Field
Delete Tax Code Accounting Field
Delete Accounting Tax Code Option
Delete Accounting Tax Code Option
Delete Accounting Tax Rate
Delete Accounting Tax Rate
Delete Accounting Vendor
Delete Accounting Vendor
Delete Custom Field Option
Delete Custom Field Option
Delete Inventory Item Field
Delete Inventory Item Field
Delete Item Receipt
Delete Item Receipt
Delete Procurement Request
Delete Procurement Request
RAMP_DELETE_PROCUREMENT_REQUESTDelete a procurement request by its unified request ID. Requires Ramp Plus and a business-scoped token; acts on behalf of the request owner. Shared procurement eligibility and request-owner permissions apply. Approved and rejected requests can be eligible for deletion. A draft can only be deleted when its owner is also its creator.Input Parameters
Output
Delete Purchase Order Line Item
Delete Purchase Order Line Item
Delete Vendor
Delete Vendor
Delete Webhook Subscription
Delete Webhook Subscription
Download Bill Remittance Receipt
Download Bill Remittance Receipt
Fetch General Ledger Account
Fetch General Ledger Account
RAMP_FETCH_ACCOUNTING_ACCOUNTTool to fetch a specific general ledger account by ID from Ramp. Use when you need to retrieve detailed information about a single GL account.Input Parameters
Output
Fetch Accounting Vendor
Fetch Accounting Vendor
RAMP_FETCH_ACCOUNTING_VENDORTool to fetch a specific accounting vendor by ID from Ramp. Use when you need to retrieve detailed information about a single accounting vendor for coding transactions, reimbursements, bills, or purchase orders.Input Parameters
Output
Fetch Custom Accounting Field
Fetch Custom Accounting Field
List General Ledger Accounts
List General Ledger Accounts
RAMP_GET_ACCOUNTING_ACCOUNTSTool to list general ledger accounts from Ramp. Use when you need to retrieve GL accounts for accounting integration or transaction categorization.Input Parameters
Output
Fetch All Accounting Connections
Fetch All Accounting Connections
Get Accounting Connection
Get Accounting Connection
Fetch Accounting Connection By ID
Fetch Accounting Connection By ID
List Custom Accounting Fields
List Custom Accounting Fields
RAMP_GET_ACCOUNTING_FIELDSTool to list custom accounting fields for coding transactions. Use when you need to retrieve custom accounting fields that can be leveraged to code transactions, reimbursements, and bills.Input Parameters
Output
Get Accounting Tax Code
Get Accounting Tax Code
RAMP_GET_ACCOUNTING_TAX_CODEFetch the tax code accounting field for the current Ramp accounting connection. To read an inactive connection’s field, supply its accounting_connection_id from List Accounting Connections. Requires accounting:read.Input Parameters
Output
List Accounting Vendors
List Accounting Vendors
RAMP_GET_ACCOUNTING_VENDORSTool to list accounting vendors from Ramp. Use when you need to retrieve vendor data for transaction coding, reimbursements, bills, or purchase orders in the accounting system.Input Parameters
Output
Get All Transactions
Get All Transactions
RAMP_GET_ALL_TRANSACTIONSList a page of Ramp transactions, with optional filters and sorting. Pagination information can be used to request subsequent pages.Input Parameters
Output
Get Bank Account
Get Bank Account
Get Banking Balance History
Get Banking Balance History
RAMP_GET_BANKING_BALANCE_HISTORYGet daily available balance history for one Ramp banking account. Obtain account_id from List Banking Accounts. Optionally filter by inclusive start_date and end_date. Returns one page; pass the start query parameter from page.next to continue. Requires treasury:read.Input Parameters
Output
Get Bill
Get Bill
Get Business
Get Business
Get Business Balance
Get Business Balance
Get Card
Get Card
Get Card Vault Resource
Get Card Vault Resource
Get Cashback
Get Cashback
Get Custom Field Option
Get Custom Field Option
Get Custom Form Collection Response
Get Custom Form Collection Response
RAMP_GET_CUSTOM_FORM_COLLECTION_RESPONSEFetch one custom form collection response by its response ID, including question labels, typed answers, comments, mappings and conditional workflows. Obtain the response ID from procurement, vendor or purchase-order custom-form metadata; a form template ID is not interchangeable. This read does not download attached files.Input Parameters
Output
Get Department
Get Department
Get Draft Bill (Beta)
Get Draft Bill (Beta)
Get Entity
Get Entity
Get Inventory Item Field
Get Inventory Item Field
Get Item Receipt
Get Item Receipt
Get Location
Get Location
Get Memo
Get Memo
Get Procurement Request
Get Procurement Request
RAMP_GET_PROCUREMENT_REQUESTRetrieve one unified procurement or spend request by its unified request ID, including ownership, amounts, status, approval history and memos. Visibility follows the connected user’s permissions. The provider marks this response schema as not finalized.Input Parameters
Output
Get Purchase Order
Get Purchase Order
Get Receipt
Get Receipt
Get Reimbursement Details
Get Reimbursement Details
Get Spend Limit
Get Spend Limit
Get Spend Program
Get Spend Program
Get Statement
Get Statement
Get Transaction Details
Get Transaction Details
Get Transfer
Get Transfer
RAMP_GET_TRANSFERFetch one Ramp transfer payment by its transfer identifier. Obtain transfer_id from List Transfer Payments. Returns amount, bank account, entity, creation time, payment identifier, and processing/accounting sync status when provided by Ramp. Requires transfers:read. This only reads a transfer.Input Parameters
Output
Get Trip
Get Trip
Get User
Get User
Get Users Deferred Status
Get Users Deferred Status
Get Vendor Details
Get Vendor Details
Get Vendor Bank Account
Get Vendor Bank Account
RAMP_GET_VENDOR_BANK_ACCOUNTFetch one vendor bank account by its vendor ID and bank account ID. Returns currency, payment method, nullable account-number last four digits, and nickname and default status when available. Use List Vendor Bank Accounts to discover account IDs. This read does not initiate a payment.Input Parameters
Output
Get Vendor Contact
Get Vendor Contact
Get Webhook
Get Webhook
Hold Bill
Hold Bill
Hold Vendor
Hold Vendor
RAMP_HOLD_VENDORBlock payments to a vendor by placing a vendor-scoped hold. Removes modifiable open, unpaid bills from scheduled payment flows. An optional reason records why the hold was placed. HTTP 202 means pending approval; only HTTP 204 confirms the vendor was placed on hold. Releasing the hold does not automatically reschedule removed payments.Input Parameters
Output
Issue Virtual Card
Issue Virtual Card
List Accounting Field Option Filter Rules
List Accounting Field Option Filter Rules
RAMP_LIST_ACCOUNTING_FIELD_OPTION_FILTER_RULESList rules determining which target accounting field options are available based on selected trigger field options. Requires Ramp Plus and accounting:read. Filter by target field or option remote ID. For an inactive accounting connection, supply its accounting_connection_id. Returns one page with a next-page URL.Input Parameters
Output
List Accounting Inventory Item Options
List Accounting Inventory Item Options
RAMP_LIST_ACCOUNTING_INVENTORY_ITEM_OPTIONSTool to list accounting inventory item options from Ramp. Use when you need to retrieve inventory items for accounting integration or transaction categorization.Input Parameters
Output
List Accounting Tax Code Options
List Accounting Tax Code Options
List Accounting Tax Rates
List Accounting Tax Rates
RAMP_LIST_ACCOUNTING_TAX_RATESTool to list tax rates from Ramp’s accounting integration. Use when you need to retrieve tax rate information for transaction categorization or tax compliance.Input Parameters
Output
List Audit Log Events
List Audit Log Events
RAMP_LIST_AUDIT_LOG_EVENTSList one page of Ramp audit log events (requires Ramp Plus). Filter by users, inclusive dates, actor/event types, agent labels, or a referenced object and resource name together. Returns native page.next; reuse its start query parameter unchanged with the same filters to retrieve the next page.Input Parameters
Output
List Bank Accounts
List Bank Accounts
RAMP_LIST_BANK_ACCOUNTSList connected Ramp bank accounts, one page at a time. Optionally filter by connection provider. Requires bank_accounts:read. Continue by passing the start query parameter from page.next with the same filter.Input Parameters
Output
List Banking Accounts
List Banking Accounts
List Bills
List Bills
RAMP_LIST_BILLSList Ramp bills using payment, status, accounting, date, and amount filters.Input Parameters
Output
List All Cards
List All Cards
List Cashbacks
List Cashbacks
RAMP_LIST_CASHBACKSList one page of cashback payments, optionally filtered by entity, statement, dates, or accounting sync status. Requires cashbacks:read. sync_status takes precedence over sync_ready. To continue, pass the start query parameter from page.next; a null page.next means there are no more pages.Input Parameters
Output
List Child Vendors
List Child Vendors
RAMP_LIST_CHILD_VENDORSList child vendors of a parent Ramp vendor. Requires an existing parent vendor ID and vendors:read. Returns one page of vendor resources and a next-page URL; pass its start cursor to continue. An empty data array is valid when the vendor has no children.Input Parameters
Output
List Departments
List Departments
List Draft Bills (Beta)
List Draft Bills (Beta)
List Entities
List Entities
RAMP_LIST_ENTITIESList Ramp business entities, one page at a time. Filter by currency, entity name, or primary status. Requires entities:read. To continue, pass the start query parameter from page.next with the same filters.Input Parameters
Output
List Item Receipts
List Item Receipts
List Locations
List Locations
List Memos
List Memos
List Merchants
List Merchants
RAMP_LIST_MERCHANTSList one page of Ramp merchants, optionally filtered by URL, name, or transaction dates. Returns merchant IDs, names, receipt-exemption flags, nullable categories, and the native page.next URL. Use its start query parameter for the next page.Input Parameters
Output
List Procurement Request Attachments
List Procurement Request Attachments
RAMP_LIST_PROCUREMENT_REQUEST_ATTACHMENTSList all non-deleted attachments on a unified procurement request, oldest first, including supporting documents and purchase order PDF attachments. Returns metadata and nullable pre-signed download URLs valid for one hour, without downloading files. Requires Ramp Plus and visibility of the request under the connected user’s permissions.Input Parameters
Output
List Procurement Requests
List Procurement Requests
RAMP_LIST_PROCUREMENT_REQUESTSList unified procurement and spend requests visible to the connected user, with filters and cursor pagination. Includes purchase orders, spend allocations, approval-only, fund restoration and travel requests. The provider marks this response schema as not finalized.Input Parameters
Output
List Purchase Orders
List Purchase Orders
List Receipt Integration Opt Out Emails
List Receipt Integration Opt Out Emails
RAMP_LIST_RECEIPT_INTEGRATION_OPT_OUT_EMAILSList emails opted out of receipt integrations. Uses a bodyless GET and wraps Ramp’s native array in data. Optional email and id query values may be ignored by Ramp: check entries rather than assuming the returned list is filtered. No pagination is exposed. Requires receipt_integrations:read.Input Parameters
Output
List Receipts
List Receipts
RAMP_LIST_RECEIPTSList one page of receipts filtered by creation dates, transaction dates or linked IDs. Optionally include structured OCR. Returns pre-signed receipt URLs (valid for one hour by default) and native page.next. For the next page, pass that URL’s start query parameter with the same filters.Input Parameters
Output
List Reimbursements
List Reimbursements
List Repayments
List Repayments
RAMP_LIST_REPAYMENTSList one page of repayments, newest creation date first. Filter by entity, funding methods, original transaction, repayment dates, accounting sync status, or user. Date filters return only completed repayments. Requires repayments:read. Pass the start query parameter from page.next to continue; null page.next marks the last page.Input Parameters
Output
List Roles
List Roles
List Spend Programs
List Spend Programs
List Spend Program Workflow Nodes
List Spend Program Workflow Nodes
RAMP_LIST_SPEND_PROGRAM_WORKFLOW_NODESList External Approval Request nodes for one Ramp spend program. Requires service_identifier and a spend program with a Blank Canvas workflow. Returns only nodes matching that non-secret integration identifier, without pagination.Input Parameters
Output
List Statements
List Statements
List Syncable Banking Transactions
List Syncable Banking Transactions
RAMP_LIST_SYNCABLE_BANKING_TRANSACTIONSList banking transactions available to sync to an accounting provider. Requires an active accounting-provider connection and treasury:read. Filter by date range, business entities, or include already-synced transfers. Returns one page; pass the start query parameter from page.next to continue.Input Parameters
Output
List Transfers
List Transfers
RAMP_LIST_TRANSFERSList one page of transfer payments filtered by status, entity, statement, dates, or accounting sync status. Requires transfers:read. sync_status takes precedence over has_no_sync_commits. Continue with the start query parameter from page.next; a null page.next means there are no more pages.Input Parameters
Output
List Trips
List Trips
RAMP_LIST_TRIPSList one page of business trips filtered by travelers, status, dates, amount or name. Returns trip details, locations, spend events and native page.next. For the next page, pass the start query parameter from that URL with the same filters.Input Parameters
Output
List Users
List Users
List Vendors
List Vendors
RAMP_LIST_VENDORSTool for listing vendors with their spending information. Returns vendor details including spending totals, categories, and activity status. Use this to analyze vendor relationships and procurement patterns.Input Parameters
Output
List Vendor Bank Accounts
List Vendor Bank Accounts
List Vendor Contacts
List Vendor Contacts
List Vendor Credits
List Vendor Credits
RAMP_LIST_VENDORS_CREDITSTool to list all vendor credits for all vendors of a business. Use when you need to track vendor credits, analyze credit usage across vendors, or reconcile vendor accounts.Input Parameters
Output
List Webhooks
List Webhooks
Mark Accounting Connection Ready to Migrate
Mark Accounting Connection Ready to Migrate
RAMP_MARK_ACCOUNTING_CONNECTION_READY_TO_MIGRATEMark an inactive API accounting connection ready for the customer’s ERP migration flow. Requires a different active accounting connection to migrate away from, a target not already marked ready, and no ERP migration already in progress. Returns the connection including is_ready_to_migrate. This makes the target selectable in Ramp’s Switch Providers UI; the customer completes the switch there.Input Parameters
Output
Mark Accounting Objects Ready to Sync
Mark Accounting Objects Ready to Sync
RAMP_MARK_ACCOUNTING_OBJECTS_READY_TO_SYNCMark Ramp transactions or reimbursements reviewed and ready for accounting sync. Flags the specified objects as reviewed and complete so they are included in the next accounting export to the connected ERP. Accepts 1–500 IDs of one supported type, all belonging to the authenticated business. Returns no fields on success (HTTP 204); this does not itself perform or confirm an ERP export.Input Parameters
Output
Options for Custom Accounting Field
Options for Custom Accounting Field
Update Accounting Connection
Update Accounting Connection
Update Card
Update Card
Update Custom Field Option
Update Custom Field Option
RAMP_PATCH_CUSTOM_FIELD_OPTIONTool to update a custom accounting field option. Use when you need to modify display name, code, value, or visibility of an existing field option.Input Parameters
Output
Update General Ledger Account
Update General Ledger Account
RAMP_PATCH_GL_ACCOUNT_RESOURCETool to update a general ledger account in Ramp. Use when you need to modify the name, code, or reactivate a deleted GL account.Input Parameters
Output
Update Inventory Item Field
Update Inventory Item Field
Upload Accounting GL Accounts
Upload Accounting GL Accounts
RAMP_POST_ACCOUNTING_ACCOUNTSTool to batch upload general ledger accounts to Ramp. Supports up to 500 accounts per call with all-or-nothing validation. Use when you need to create GL accounts in Ramp’s accounting system.Input Parameters
Output
Post Accounting Codings
Post Accounting Codings
RAMP_POST_ACCOUNTING_CODINGSPost accounting coding selections to an existing Ramp card transaction. Select field options, supply free-form text, or explicitly clear an option by sending null without free_form_text. Returns the coded object and selections. This changes accounting coding; it does not create a transaction or payment.Input Parameters
Output
Create Accounting Connection
Create Accounting Connection
RAMP_POST_ACCOUNTING_CONNECTIONTool to register a new API-based accounting connection between Ramp and an accounting provider. Use when establishing a new connection to accounting systems like QuickBooks, NetSuite, or Xero. If a Universal CSV connection exists, it will be upgraded to an API-based connection.Input Parameters
Output
Post Accounting Syncs
Post Accounting Syncs
RAMP_POST_ACCOUNTING_SYNCSReport successful and failed ERP sync results for Ramp objects. Updates accounting sync status rather than exporting objects to an ERP. Supply object IDs and a unique idempotency key; reuse the key for identical retries. Requires an active API-based ERP accounting connection. Returns the sync job ID.Input Parameters
Output
Upload Accounting Vendors
Upload Accounting Vendors
RAMP_POST_ACCOUNTING_VENDORSTool to batch upload vendors to Ramp for coding transactions, bills, and purchase orders. Supports up to 500 vendors per call with all-or-nothing validation. Use when you need to create vendors in Ramp’s accounting system.Input Parameters
Output
Upload Inventory Item Options
Upload Inventory Item Options
RAMP_POST_INVENTORY_ITEM_OPTIONSTool to upload inventory item options for an active inventory item accounting field. Use when you need to create inventory items in Ramp’s accounting system.Input Parameters
Output
Create Physical Card
Create Physical Card
RAMP_POST_PHYSICAL_CARDTool to create a physical card asynchronously. Returns a task ID which can be used to track the card creation status. Physical cards require fulfillment details with a shipping address. Use when a user needs a physical card for in-person transactions.Input Parameters
Output
Reactivate Accounting Connection
Reactivate Accounting Connection
RAMP_REACTIVATE_ACCOUNTING_CONNECTIONTool to reactivate a previously unlinked accounting connection by changing its status back to linked. This preserves all previous accounting field configurations and settings. Use when you need to restore a disconnected accounting integration. The business must not have any other active accounting connections.Input Parameters
Output
Reactivate User
Reactivate User
Release Bill Hold
Release Bill Hold
Release Vendor
Release Vendor
RAMP_RELEASE_VENDORRelease the active vendor-scoped hold to allow new payments to be scheduled. Payments removed from scheduled payment flows during the hold must be scheduled again after release. A pending-approval result does not confirm release; check the vendor’s status before scheduling payments.Input Parameters
Output
Remove Receipt Integration Opt Out Email
Remove Receipt Integration Opt Out Email
Resolve External Approval
Resolve External Approval
RAMP_RESOLVE_EXTERNAL_APPROVALApprove or reject a blank canvas external approval workflow step. Requires blank_canvas:write and the approval trigger instance UUID for the workflow step. This resolves that step and can advance or reject its workflow; it does not create an approval request. Returns the provider’s result message.Input Parameters
Output
Submit Draft Bill (Beta)
Submit Draft Bill (Beta)
Submit Procurement Request
Submit Procurement Request
RAMP_SUBMIT_PROCUREMENT_REQUESTSubmit a procurement draft for approval and return its request detail. Requires Ramp Plus and unified_requests:write. An incomplete draft fails with DEVELOPER_7195; additional_info.validation_errors and additional_info.fields_to_answer describe the missing information. Submission enters the configured approval workflow and may notify its participants.Input Parameters
Output
Submit Reimbursement Receipt
Submit Reimbursement Receipt
RAMP_SUBMIT_REIMBURSEMENT_RECEIPTTool to upload a receipt for a reimbursement. Use when submitting receipts for out-of-pocket expenses. If reimbursement_id is provided, attaches the receipt to an existing reimbursement; otherwise creates a new draft reimbursement via OCR.Input Parameters
Output
Suspend Card
Suspend Card
RAMP_SUSPEND_CARDTool to suspend a card by creating an async task that locks the card from use. Use when you need to temporarily disable a card. The suspension is revertable.Input Parameters
Output
Terminate Card
Terminate Card
RAMP_TERMINATE_CARDTool to permanently terminate a Ramp card. This action creates an async task to terminate the card and is irreversible. Use when you need to permanently deactivate a card. The response contains a task ID that can be used to check the termination status.Input Parameters
Output
Update Custom Accounting Field
Update Custom Accounting Field
Update Accounting Inventory Item Option
Update Accounting Inventory Item Option
Update Accounting Tax Code
Update Accounting Tax Code
Update Accounting Tax Code Option
Update Accounting Tax Code Option
RAMP_UPDATE_ACCOUNTING_TAX_CODE_OPTIONSTool to update a tax code option in Ramp. Use when you need to modify the name or associated tax rates of an existing tax code option.Input Parameters
Output
Update Accounting Tax Rate
Update Accounting Tax Rate
Update Accounting Vendor
Update Accounting Vendor
RAMP_UPDATE_ACCOUNTING_VENDORTool to update an accounting vendor in Ramp. Use when you need to modify vendor details such as name or code, or reactivate a deleted vendor.Input Parameters
Output
Update Bill
Update Bill
RAMP_UPDATE_BILLUpdate an approved Ramp bill. Ramp rejects updates to bills that are not approved.Input Parameters
Output
Update Card Spending Limit
Update Card Spending Limit
Update Custom Accounting Field Option
Update Custom Accounting Field Option
RAMP_UPDATE_CUSTOM_ACCOUNTING_FIELD_OPTIONUpdate an existing custom accounting field option by ID. Change display name, visibility, entity availability, or (without a direct ERP integration) code, value, and reactivation. Omitted fields remain unchanged; entity_remote_ids=null resets availability to all connected entities. Returns the updated option. Requires accounting:write.Input Parameters
Output
Update Department
Update Department
Update Draft Bill (Beta)
Update Draft Bill (Beta)
RAMP_UPDATE_DRAFT_BILLBeta: update only explicitly supplied fields on a Ramp draft bill.Input Parameters
Output
Update External Approval Metadata
Update External Approval Metadata
RAMP_UPDATE_EXTERNAL_APPROVAL_METADATAUpdate display metadata for a Ramp blank canvas external approval request. Supply an existing approval trigger instance UUID and any recipients, display status, or approval URL to send in the PATCH. Omitted metadata fields are not sent; explicit nulls are preserved. This updates metadata, not the approval decision. Returns the approval trigger instance ID and saved metadata. Requires blank_canvas:write.Input Parameters
Output
Update Spending Limit
Update Spending Limit
RAMP_UPDATE_LIMITSUpdate a Ramp spending limit, including its display name, spending restrictions, permitted spend types, or user assignment. The tool then fetches the updated limit; that read can fail after the update succeeds.Input Parameters
Output
Update Location
Update Location
RAMP_UPDATE_LOCATIONUpdate a Ramp location’s name and optionally its business entity. Name is required even when changing the entity. Changing entity_id also moves existing users assigned to this location to the updated entity. Returns the location ID, name, and entity ID. Requires locations:write.Input Parameters
Output
Update Procurement Request
Update Procurement Request
RAMP_UPDATE_PROCUREMENT_REQUESTEdit an owned native draft or submitted Ramp Plus procurement request. Never submits a draft. Submitted edits undergo normal approval reconciliation. Collections replace the complete saved set: re-send every answer, coding selection and line to retain. Omitted/null line descriptions are cleared. Returns request detail with saved purchase-order coding and lines.Input Parameters
Output
Update Purchase Order
Update Purchase Order
RAMP_UPDATE_PURCHASE_ORDERUpdate an approved Ramp Plus purchase order; unapproved orders are rejected by Ramp.Input Parameters
Output
Update Purchase Order Line Item
Update Purchase Order Line Item
RAMP_UPDATE_PURCHASE_ORDER_LINE_ITEMUpdate one line item on an approved Ramp Plus purchase order.Input Parameters
Output
Update User
Update User
RAMP_UPDATE_USERTool to update an existing user in your Ramp organization. Use when modifying user information such as name, department, role, or manager assignments.Input Parameters
Output
Update Vendor
Update Vendor
RAMP_UPDATE_VENDORUpdate an existing Ramp vendor by UUID. Omitted fields remain unchanged. Explicit null clears nullable fields such as default_entity_id and net_payment_terms; an empty display_name clears it. Payment/tax detail requests require an existing default contact email.Input Parameters
Output
Update Vendor Bank Accounts
Update Vendor Bank Accounts
RAMP_UPDATE_VENDOR_BANK_ACCOUNTSAdd vendor payment details through Ramp’s approval workflow. Supports US ACH, US wire, and stablecoin wallet details. Returns approved when applied immediately, or pending_approval with a proposal ID when business policies require approval. This adds payment details; it does not send a payment.Input Parameters
Output
Upload Bill Attachment
Upload Bill Attachment
Upload Draft Bill Attachment
Upload Draft Bill Attachment
Upload External Approval Document
Upload External Approval Document
RAMP_UPLOAD_EXTERNAL_APPROVAL_DOCUMENTUpload a document for a blank canvas external approval workflow step. The unified request must be associated with a spend request. Sends the document and its category as multipart parts. Returns an empty object on success (HTTP 204).Input Parameters
Output
Upload New Options for Custom Accounting Field
Upload New Options for Custom Accounting Field
Upload Procurement Request Attachment
Upload Procurement Request Attachment
RAMP_UPLOAD_PROCUREMENT_REQUEST_ATTACHMENTUpload a supporting document or purchase-order attachment to a procurement request. Requires Ramp Plus. Supporting documents are not shared with the vendor; PURCHASE_ORDER files are appended to the purchase order PDF sent to the vendor. Returns the attachment ID. An idempotency key is required for retries.Input Parameters
Output
Upload Receipt
Upload Receipt
RAMP_UPLOAD_RECEIPTUpload a receipt image or PDF for a Ramp user. Optionally attach it to a transaction. When transaction_id is omitted, Ramp attempts automatic transaction matching; omission does not guarantee an unattached receipt. Returns the receipt identifier when supplied by Ramp.Input Parameters
Output
Upload Tax Code Options
Upload Tax Code Options
RAMP_UPLOAD_TAX_CODE_OPTIONSTool to upload tax code options to Ramp. Use when you need to create or update tax codes in the accounting system. Requires an active tax code accounting field for the accounting connection.Input Parameters
Output
Upload Accounting Tax Rates
Upload Accounting Tax Rates
RAMP_UPLOAD_TAX_RATESTool to batch upload tax rates to Ramp. Supports up to 500 tax rates per call with all-or-nothing validation. Use when you need to create tax rates in Ramp’s accounting system. Ensure data is sanitized and tax rates do not already exist before uploading.Input Parameters
Output
Verify Webhook
Verify Webhook
RAMP_VERIFY_WEBHOOKVerify a pending webhook subscription using its delivered challenge. Use after your HTTPS receiver has received and acknowledged Ramp’s webhooks.verification request. A successful verification activates the subscription so it can receive its subscribed business events. This action submits the challenge; it does not verify signatures of incoming events.