> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ramp

> Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business

![Ramp logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/ramp.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=9d05d1203bc6b897c5f3ca00061a38c3)

* **Category:** accounting
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 111
* **Triggers:** 0
* **Slug:** `RAMP`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Purchase Order Line Items
>
> **Slug:** `RAMP_ADD_PURCHASE_ORDER_LINE_ITEMS`
>
> Add line items to an existing Ramp Plus purchase order.
>
> #### Input Parameters
>
> **line\_items** `array` *required*
>
> Line items to add; existing purchase order line items are not modified.
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID that will receive the new line items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Receipt Integration Opt Out Email
>
> **Slug:** `RAMP_ADD_RECEIPT_INTEGRATION_OPT_OUT_EMAIL`
>
> Add 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
>
> **email** `string` *required*
>
> Email address to add to the receipt integrations opt-out list.
>
> **business\_id** `integer`
>
> Optional integer business ID. Omit to use the connected business.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Bill
>
> **Slug:** `RAMP_ARCHIVE_BILL`
>
> Archive a bill, cancelling inflight payments or terminating its one-time card where possible. Paid and batch-payment bills cannot be archived.
>
> #### Input Parameters
>
> **bill\_id** `string` *required*
>
> UUID of the bill to archive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Purchase Order
>
> **Slug:** `RAMP_ARCHIVE_PURCHASE_ORDER`
>
> Archive a Ramp Plus purchase order. This destructive operation is irreversible.
>
> #### Input Parameters
>
> **archived\_reason** `string`
>
> Optional reason for archiving. Pass null explicitly to record no reason.
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID to archive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Vendor Bank Account
>
> **Slug:** `RAMP_ARCHIVE_VENDOR_BANK_ACCOUNT`
>
> Archive 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
>
> **vendor\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor that owns the account.
>
> **bank\_account\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor bank account to archive.
>
> **replacement\_bank\_account\_id** `string`
>
> Replacement bank account ID (UUID). Required when the archived account has associated bills, drafts, or recurring templates; those associations are transferred to this account. May be omitted or null otherwise.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Accounting Field Option Filter Rules
>
> **Slug:** `RAMP_CREATE_ACCOUNTING_FIELD_OPTION_FILTER_RULES`
>
> Create 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
>
> **rules** `array` *required*
>
> Field option filter rules to create (1–1000).
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required for rules on an inactive connection; otherwise omit or send null to use the active connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Bill
>
> **Slug:** `RAMP_CREATE_BILL`
>
> Create a Ramp bill. Ramp does not support creating batch payments through this API.
>
> #### Input Parameters
>
> **memo** `string`
>
> Internal bill memo.
>
> **due\_at** `string` *required*
>
> Due date of the bill.
>
> **entity\_id** `string` *required*
>
> UUID of the business entity associated with the bill.
>
> **issued\_at** `string` *required*
>
> Date the invoice was issued.
>
> **remote\_id** `string`
>
> Client-side bill ID; requires an accounting connection and enable\_accounting\_sync=true.
>
> **vendor\_id** `string` *required*
>
> UUID of the bill vendor.
>
> **line\_items** `array`
>
> Expense line items on the bill.
>
> **vendor\_memo** `string`
>
> Memo shown to the vendor.
>
> **payment\_date** `string`
>
> For non-card bills, requested payment initiation date; Ramp moves unavailable dates to the next valid date.
>
> **posting\_date** `string`
>
> Date the bill is posted to the accounting system.
>
> **attachment\_id** `string`
>
> UUID of a previously uploaded file to attach.
>
> **invoice\_number** `string` *required*
>
> Invoice number on the bill.
>
> **payment\_method** `string ("ACH" | "CARD" | "CHECK" | "CRYPTO_WALLET_TRANSFER" | "DOMESTIC_WIRE" | "INTERNATIONAL" | "LOCAL_BANK_TRANSFER" | "ONE_TIME_CARD" | "ONE_TIME_CARD_DELIVERY" | "PAID_MANUALLY" | "SWIFT")`
>
> Payment method; required unless use\_default\_payment\_method is true.
>
> **payment\_details** `string`
>
> Payment-method-specific bank account, check, card, or manual payment details.
>
> **invoice\_currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDSUI" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")` *required*
>
> ISO 4217 currency code of the invoice.
>
> **vendor\_contact\_id** `string`
>
> Vendor contact UUID; required unless use\_default\_vendor\_contact is true.
>
> **purchase\_order\_ids** `array`
>
> Purchase order UUIDs to match to the bill.
>
> **inventory\_line\_items** `array`
>
> Inventory line items on the bill.
>
> **enable\_accounting\_sync** `boolean`
>
> Whether to sync the bill to the ERP; this must be true when remote\_id is provided.
>
> **use\_default\_payment\_method** `boolean`
>
> Use the vendor's default payment method; when true, omit payment\_method and payment\_details.
>
> **use\_default\_vendor\_contact** `boolean`
>
> Use the vendor's default contact; when true, omit vendor\_contact\_id.
>
> **accounting\_field\_selections** `array`
>
> Accounting field options used to code the bill.
>
> **target\_payment\_arrival\_date** `string`
>
> Target vendor arrival date when using the vendor's default payment method.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Card Embed Token
>
> **Slug:** `RAMP_CREATE_CARD_EMBED_TOKEN`
>
> Create 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
>
> **card\_id** `string` *required*
>
> Identifier of an activated, currently active card.
>
> **parent\_origin** `string` *required*
>
> HTTP or HTTPS origin URL with hostname for the parent embedding the card (for example [https://app.ramp.com/](https://app.ramp.com/)). Localhost origins are restricted in production.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Card Vault
>
> **Slug:** `RAMP_CREATE_CARD_VAULT`
>
> Create 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
>
> **user\_id** `string` *required*
>
> UUID of the card owner.
>
> **display\_name** `string`
>
> Cosmetic display name of the limit.
>
> **idempotency\_key** `string`
>
> Optional client-generated X-Idempotency-Key header. Reuse for retries of the same creation.
>
> **accounting\_rules** `array`
>
> Accounting rules for the limit and card.
>
> **spend\_program\_id** `string`
>
> Associated spend program UUID. Its restrictions override spending\_restrictions when supplied.
>
> **spending\_restrictions** `object`
>
> Spending restrictions; ignored when spend\_program\_id is supplied.
>
> **allowed\_overage\_percent\_override** `string`
>
> Fund-level overage override from 0 to 100; 10 means 10%. Omitted or null inherits the spend program or business default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Department
>
> **Slug:** `RAMP_CREATE_DEPARTMENT`
>
> Tool for creating a new department in your Ramp organization. Perfect for setting up organizational structure and expense categorization.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the department
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Draft Bill (Beta)
>
> **Slug:** `RAMP_CREATE_DRAFT_BILL`
>
> Beta: create a Ramp draft bill for a vendor without submitting it.
>
> #### Input Parameters
>
> **memo** `string`
>
> Internal bill memo. Use the update action's clear\_fields parameter to clear it later.
>
> **due\_at** `string`
>
> Bill due date in YYYY-MM-DD format.
>
> **entity\_id** `string`
>
> UUID of the associated business entity.
>
> **issued\_at** `string`
>
> Invoice issue date in YYYY-MM-DD format.
>
> **remote\_id** `string`
>
> Client-side bill identifier. Use the update action's clear\_fields parameter to clear it later.
>
> **vendor\_id** `string` *required*
>
> UUID of the bill vendor.
>
> **line\_items** `array`
>
> Bill line items. When supplied, replaces all existing line items; use the update action's clear\_fields parameter to clear them later.
>
> **vendor\_memo** `string`
>
> Memo shown to the vendor. Use the update action's clear\_fields parameter to clear it later.
>
> **posting\_date** `string`
>
> Accounting-system posting date in YYYY-MM-DD format. Use the update action's clear\_fields parameter to clear it later.
>
> **invoice\_number** `string`
>
> Invoice number on the bill.
>
> **payment\_method** `string ("ACH" | "CARD" | "CHECK" | "CRYPTO_WALLET_TRANSFER" | "DOMESTIC_WIRE" | "INTERNATIONAL" | "LOCAL_BANK_TRANSFER" | "ONE_TIME_CARD" | "ONE_TIME_CARD_DELIVERY" | "PAID_MANUALLY" | "SWIFT")`
>
> Payment method for the bill.
>
> **invoice\_currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDSUI" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")`
>
> ISO 4217 currency code for the invoice.
>
> **vendor\_contact\_id** `string`
>
> UUID of a contact belonging to the selected vendor.
>
> **purchase\_order\_ids** `array`
>
> Purchase order UUIDs to match. Ramp accepts these IDs but does not expose the draft-bill relationship in its read API; successful submission cannot independently confirm that the linkage persisted.
>
> **inventory\_line\_items** `array`
>
> Inventory line items. When supplied, replaces all existing inventory line items; use the update action's clear\_fields parameter to clear them later.
>
> **enable\_accounting\_sync** `boolean`
>
> Set false to prevent the bill from syncing to the ERP.
>
> **use\_default\_payment\_method** `boolean`
>
> Use the vendor's default payment method. Do not also provide payment\_method when true.
>
> **accounting\_field\_selections** `array`
>
> Accounting field options used to code the draft bill.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Draft Spend Request Via OCR
>
> **Slug:** `RAMP_CREATE_DRAFT_SPEND_REQUEST_VIA_OCR`
>
> Create 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
>
> **document** `object` *required*
>
> Document to use to create the draft spend request.
>
> **idempotency\_key** `string` *required*
>
> Client-generated unique value identifying retries of the same request. A random UUID is recommended.
>
> **spend\_intent\_id** `string` *required*
>
> Procurement spend intent (spend program) to associate with the spend request; SpendLimit programs are not supported.
>
> **requester\_user\_id** `string` *required*
>
> User to associate with the spend request.
>
> **purchase\_order\_number\_number** `string`
>
> Purchase order number, as an integer in string format.
>
> **purchase\_order\_number\_prefix** `string`
>
> Prefix of the purchase order number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Inventory Item Accounting Field
>
> **Slug:** `RAMP_CREATE_INVENTORY_ITEM_ACCOUNTING_FIELD`
>
> Tool 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
>
> **name** `string` *required*
>
> Name of the inventory item tracking category in the remote ERP system
>
> **display\_name** `string`
>
> The name of the inventory item tracking category as shown on Ramp. If not provided, defaults to the name field
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Item Receipt
>
> **Slug:** `RAMP_CREATE_ITEM_RECEIPT`
>
> Create 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
>
> **memo** `string`
>
> Receipt memo, or null.
>
> **received\_at** `string` *required*
>
> Date the vendor delivers the goods or services (YYYY-MM-DD).
>
> **purchase\_order\_id** `string` *required*
>
> UUID of the purchase order to attach this receipt to.
>
> **item\_receipt\_number** `string` *required*
>
> User-defined item receipt number.
>
> **item\_receipt\_line\_items** `array` *required*
>
> Purchase order line items to receive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Location
>
> **Slug:** `RAMP_CREATE_LOCATION`
>
> Create 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
>
> **name** `string` *required*
>
> Name of the location.
>
> **entity\_id** `string`
>
> UUID of the business entity this location belongs to. Omit if not needed; explicit null is not supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Transaction Memo
>
> **Slug:** `RAMP_CREATE_MEMO`
>
> Tool for uploading a new memo for a transaction in Ramp. Use when you need to add notes or context to existing transactions.
>
> #### Input Parameters
>
> **memo** `string` *required*
>
> Text content of the memo to create. Maximum length is 255 characters.
>
> **transaction\_id** `string` *required*
>
> Unique identifier for the transaction to attach the memo to
>
> **is\_memo\_recurring** `boolean`
>
> Whether this memo should automatically apply to similar future transactions. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Mileage Reimbursement
>
> **Slug:** `RAMP_CREATE_MILEAGE_REIMBURSEMENT`
>
> Tool 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
>
> **memo** `string` *required*
>
> Memo or note describing the purpose of the mileage reimbursement. This field is required.
>
> **distance** `string` *required*
>
> Distance traveled for the reimbursement. Can be specified as a number or string.
>
> **trip\_date** `string` *required*
>
> Date of the trip in ISO 8601 date format (YYYY-MM-DD).
>
> **waypoints** `array`
>
> List of intermediate stops during the trip.
>
> **end\_location** `string`
>
> Ending location of the trip.
>
> **reimbursee\_id** `string` *required*
>
> Unique identifier (UUID) of the user to be reimbursed.
>
> **distance\_units** `string ("KILOMETERS" | "MILES")`
>
> Distance units for mileage reimbursement.
>
> **start\_location** `string`
>
> Starting location of the trip.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Mock Webhook Event
>
> **Slug:** `RAMP_CREATE_MOCK_WEBHOOK_EVENT`
>
> Create 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
>
> **object\_id** `string` *required*
>
> UUID of the object associated with the event.
>
> **event\_type** `string ("applications.status_updated" | "bills.approved" | "bills.archived" | "bills.created" | "bills.paid" | "bills.ready_to_sync" | "bills.rejected" | "bills.updated" | "draft_bills.created" | "entities.created" | "item_receipts.created" | "payments.updated" | "purchase_orders.archived" | "purchase_orders.created" | "purchase_orders.updated" | "reimbursements.batch_payment_reimbursed" | "reimbursements.ready_for_review" | "reimbursements.ready_to_sync" | "reimbursements.sync_requested" | "spend_requests.comment_created" | "spend_requests.created" | "tests.test_event" | "transactions.all_requirements_met_and_approved_changed" | "transactions.authorized" | "transactions.body_coding_updated" | "transactions.cleared" | "transactions.declined" | "transactions.ready_for_review" | "transactions.ready_to_sync" | "transactions.receipt_added" | "transactions.sync_requested" | "transactions.synced" | "unified_requests.created" | "unified_requests.external_approval_request" | "unified_requests.external_approval_request_reset" | "unified_requests.modified" | "unified_requests.node_advanced" | "unified_requests.override_approved" | "unified_requests.updated" | "users.invite_accepted" | "vendor_agreements.archived" | "vendor_agreements.created" | "vendor_agreements.deleted" | "vendor_agreements.document_added" | "vendor_agreements.renewal_milestone" | "vendor_agreements.updated" | "vendors.activated" | "vendors.approved" | "vendors.updated" | "webhooks.verification")` *required*
>
> Type of the webhook event.
>
> **object\_metadata** `object` *required*
>
> Additional metadata associated with the event.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create New Custom Accounting Field
>
> **Slug:** `RAMP_CREATE_NEW_CUSTOM_ACCOUNTING_FIELD`
>
> Tool for creating a new custom accounting field. Note: This operation requires elevated permissions not available in the demo API.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Remote/external ID of custom accounting field from ERP system.
>
> **name** `string` *required*
>
> Name of the custom accounting field.
>
> **input\_type** `string ("SINGLE_CHOICE" | "BOOLEAN" | "FREE_FORM_TEXT")` *required*
>
> The input type could be SINGLE\_CHOICE, BOOLEAN or FREE\_FORM\_TEXT.
>
> **is\_splittable** `boolean`
>
> If set to True, the accounting field can be used to annotate split line items.
>
> **is\_required\_for** `array`
>
> Types of objects that require this accounting field to be used for coding before they can be marked as ready to sync.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Procurement Request
>
> **Slug:** `RAMP_CREATE_PROCUREMENT_REQUEST`
>
> Create 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
>
> **name** `string`
>
> Request name.
>
> **submit** `boolean`
>
> Submit into the approval flow by default. Set false to create a draft.
>
> **currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MUR" | "MRU" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDG" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")` *required*
>
> Request currency code supported by Ramp.
>
> **end\_date** `string`
>
> Spend period end, YYYY-MM-DD.
>
> **entity\_id** `string`
>
> Business entity ID; defaults to program or requester entity.
>
> **line\_items** `array`
>
> Request line items; purchase-order programs only.
>
> **start\_date** `string`
>
> Spend period start, YYYY-MM-DD.
>
> **field\_answers** `array`
>
> Form answers whose answer\_type matches each program form field. File-upload fields are unsupported.
>
> **idempotency\_key** `string`
>
> Optional client-generated X-Idempotency-Key header to make retries idempotent; 1–255 characters.
>
> **request\_owner\_id** `string` *required*
>
> Owner user ID. Approvals route as if this user submitted the request.
>
> **spend\_program\_id** `string` *required*
>
> Procurement spend program ID; other program types are rejected.
>
> **accounting\_field\_selections** `array`
>
> Request-level selections; purchase-order programs only, limited to enabled fields allowed by the ERP.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Purchase Order
>
> **Slug:** `RAMP_CREATE_PURCHASE_ORDER`
>
> Create a purchase order. Purchase Orders require a Ramp Plus account.
>
> #### Input Parameters
>
> **memo** `string`
>
> Purchase order memo.
>
> **currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDSUI" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")` *required*
>
> Ramp-supported purchase order currency code.
>
> **owner\_id** `string`
>
> Owner ID; defaults to the API caller when omitted.
>
> **entity\_id** `string` *required*
>
> Associated business entity ID.
>
> **vendor\_id** `string`
>
> Associated vendor ID.
>
> **line\_items** `array` *required*
>
> Line items for the purchase order.
>
> **external\_id** `string`
>
> Unique, immutable client-side purchase order ID.
>
> **promise\_date** `string`
>
> Date the vendor promises delivery.
>
> **spend\_end\_date** `string`
>
> Date when purchase order spending ends.
>
> **spend\_start\_date** `string`
>
> Date when purchase order spending begins.
>
> **net\_payment\_terms** `integer`
>
> Invoice payment term in days.
>
> **purchase\_order\_number** `string`
>
> Unique purchase order number; Ramp generates one when omitted.
>
> **three\_way\_match\_enabled** `boolean` *required*
>
> Whether item receipts are required for three-way matching.
>
> **withholding\_default\_rate** `string`
>
> Default retainage rate as a fraction from 0 (inclusive) to 1 (exclusive).
>
> **accounting\_field\_selections** `array`
>
> Body-level accounting coding selections.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Spend Program
>
> **Slug:** `RAMP_CREATE_SPEND_PROGRAM`
>
> Create 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
>
> **icon** `string ("AccountingServicesIcon" | "AdvertisingIcon" | "CONTRACTORS_AND_PROFESSIONAL_SERVICES" | "CUSTOM" | "CardIcon" | "EducationStipendIcon" | "EmployeeRewardsIcon" | "GroundTransportationIcon" | "LegalFeesIcon" | "LodgingIcon" | "LunchOrderingIcon" | "OnboardingIcon" | "PerDiemCardIcon" | "SOFTWARE" | "SaasSubscriptionIcon" | "SoftwareTrialIcon" | "SuppliesIcon" | "TeamSocialIcon" | "TravelExpensesIcon" | "VirtualEventIcon" | "WellnessIcon" | "WorkFromHomeIcon" | "advertising" | "airlines" | "bills" | "business" | "car_services" | "contractor" | "education" | "entertainment" | "event_balloons" | "event_virtual" | "food" | "fuel_and_gas" | "general_expense" | "general_merchandise" | "gift" | "government_services" | "internet_and_phone" | "legal" | "lodging" | "lodging_room" | "newspaper" | "office" | "physical_card" | "procurement_checklist" | "procurement_intake" | "professional_services" | "restaurants" | "reward" | "saas_software" | "shipping" | "travel_misc" | "wellness")` *required*
>
> Ramp template icon.
>
> **description** `string` *required*
>
> Description of the spend program.
>
> **display\_name** `string` *required*
>
> Display name of the spend program.
>
> **is\_shareable** `boolean`
>
> Allow sharing among multiple users.
>
> **issuance\_rules** `object`
>
> Optional automatic issuance and requestability rules.
>
> **permitted\_spend\_types** `object` *required*
>
> Permitted spending methods.
>
> **spending\_restrictions** `object` *required*
>
> Restrictions imposed on the spend program.
>
> **issue\_physical\_card\_if\_needed** `boolean`
>
> Issue a physical card if the user has none.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tax Code Accounting Field
>
> **Slug:** `RAMP_CREATE_TAX_CODE_ACCOUNTING_FIELD`
>
> Tool 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
>
> **name** `string` *required*
>
> Name of the tax code field in the remote ERP system.
>
> **display\_name** `string`
>
> The name of the tax code field as shown on Ramp. If not provided, the name field will be used as the display name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create User Invite
>
> **Slug:** `RAMP_CREATE_USER_INVITE`
>
> Tool 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
>
> **role** `string ("AUDITOR" | "BUSINESS_ADMIN" | "BUSINESS_BOOKKEEPER" | "BUSINESS_OWNER" | "BUSINESS_USER" | "GUEST_USER" | "IT_ADMIN")` *required*
>
> The employee's role in the organization. Note that BUSINESS\_OWNER is not an invitable role
>
> **email** `string` *required*
>
> The employee's email address where the invite will be sent
>
> **last\_name** `string` *required*
>
> Last name of the employee (max 255 characters)
>
> **first\_name** `string` *required*
>
> First name of the employee (max 255 characters)
>
> **is\_manager** `boolean`
>
> Whether the employee is a manager
>
> **location\_id** `string`
>
> Unique identifier of the employee's location. Use this to assign the user to a specific entity (locations are mapped to entities with many-to-one relationship)
>
> **department\_id** `string`
>
> Unique identifier of the employee's department (UUID format)
>
> **idempotency\_key** `string` *required*
>
> A unique value generated by the client which the server uses to recognize subsequent retries of the same request. Use a random generated UUID to avoid collisions
>
> **direct\_manager\_id** `string`
>
> Unique identifier of the employee's direct manager (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Vendor
>
> **Slug:** `RAMP_CREATE_VENDOR`
>
> Create 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
>
> **name** `string`
>
> New vendor name.
>
> **state** `string`
>
> Vendor-level two-letter US state; ignored for non-US countries.
>
> **address** `object`
>
> Vendor address.
>
> **country** `string`
>
> Vendor country; defaults to US when omitted or null.
>
> **acting\_user\_id** `string`
>
> Deprecated and ignored; use requesting\_user\_id instead.
>
> **vendor\_owner\_id** `string`
>
> Owner user UUID; omitted means no owner.
>
> **parent\_vendor\_id** `string`
>
> Parent vendor UUID.
>
> **default\_entity\_id** `string`
>
> Default entity UUID belonging to this business; omitted means none.
>
> **net\_payment\_terms** `integer`
>
> Days until payment due; 0 is due on receipt. Null clears; omission may inherit parent terms.
>
> **external\_vendor\_id** `string`
>
> Customer-defined ID independent of accounting remote IDs.
>
> **requesting\_user\_id** `string`
>
> Ramp user UUID recorded as payment/tax requestor. Requires an admin/owner token; omission uses existing creation behavior.
>
> **request\_tax\_details** `boolean`
>
> Request tax information; requires a contact email.
>
> **request\_payment\_details** `boolean`
>
> Request bank/wire/check details; requires a contact email.
>
> **business\_vendor\_contacts** `object` *required*
>
> Detailed information about the vendor contact.
>
> **accounting\_vendor\_remote\_id** `string`
>
> Accounting remote ID; mutually exclusive with vendor\_tracking\_category\_option\_id. Must not already be linked to another Ramp vendor.
>
> **vendor\_tracking\_category\_option\_id** `string`
>
> Ramp accounting vendor UUID; mutually exclusive with accounting\_vendor\_remote\_id. Must not already be linked to another vendor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Vendor Contact
>
> **Slug:** `RAMP_CREATE_VENDOR_CONTACT`
>
> Create a contact for an existing Ramp vendor. Returns approved with a contact ID when applied immediately, or pending\_approval with a proposal ID when vendor approval is required. Use Get Vendor Contact to read the created contact once approved.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Contact email address.
>
> **phone** `string`
>
> Contact phone number; may be null.
>
> **last\_name** `string`
>
> Contact last name; may be null.
>
> **vendor\_id** `string` *required*
>
> UUID of the vendor receiving the contact.
>
> **first\_name** `string`
>
> Contact first name; may be null.
>
> **is\_default** `boolean`
>
> Whether this is the default contact.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook Subscription
>
> **Slug:** `RAMP_CREATE_WEBHOOK_SUBSCRIPTION`
>
> Tool 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
>
> **event\_types** `array` *required*
>
> List of event types to subscribe to. The webhook will receive notifications for these events
>
> **endpoint\_url** `string` *required*
>
> URL where webhook events will be sent. Must be a valid HTTPS URL that can receive POST requests
>
> **additional\_headers** `object`
>
> Optional headers to include with webhook requests. Max 5 headers allowed. Header names max 100 chars, values max 1000 chars
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Deactivate User
>
> **Slug:** `RAMP_DEACTIVATE_USER`
>
> Tool to deactivate a user in your Ramp organization. Use when you need to prevent a user from logging in, spending on cards, or receiving notifications. Once deactivated, users cannot access their Ramp account or perform any actions.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The unique identifier (UUID) of the user to deactivate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting GL Account
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_ACCOUNT`
>
> Tool to delete a general ledger account from Ramp. Use when you need to remove a GL account from the accounting system.
>
> #### Input Parameters
>
> **gl\_account\_id** `string` *required*
>
> The unique identifier (UUID) of the general ledger account to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Connection
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_CONNECTION`
>
> Tool 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Field Option Filter Rules
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_FIELD_OPTION_FILTER_RULES`
>
> Bulk 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
>
> **rules** `array` *required*
>
> Rules to delete, identified by target field, target option, and required selections.
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required for rules belonging to an inactive accounting connection; otherwise omit or send null.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Custom Accounting Field
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_FIELDS`
>
> Tool to delete a custom accounting field from Ramp. Use when you need to remove a custom accounting field from the system. Note: Fields are read-only and cannot be deleted when a direct accounting connection is enabled.
>
> #### Input Parameters
>
> **field\_id** `string` *required*
>
> The unique identifier (UUID) of the custom accounting field to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Inventory Item Option
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_INVENTORY_ITEM_OPTIONS`
>
> Tool to delete an accounting inventory item option from Ramp. Use when you need to remove an inventory item option from the accounting system.
>
> #### Input Parameters
>
> **option\_id** `string` *required*
>
> The unique identifier (UUID) of the inventory item option to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Tax Code Accounting Field
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_TAX_CODE`
>
> Tool to delete the tax code accounting field from Ramp. Use when you need to remove the tax code field configuration. Note: The tax code field must exist before deletion.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Tax Code Option
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_TAX_CODE_OPTIONS`
>
> Tool to delete a tax code option from Ramp. Use when you need to remove a tax code option from the accounting system.
>
> #### Input Parameters
>
> **option\_id** `string` *required*
>
> The unique identifier (UUID) of the tax code option to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Tax Rate
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_TAX_RATES`
>
> Tool to delete an accounting tax rate from Ramp. Use when you need to remove a tax rate from the accounting system.
>
> #### Input Parameters
>
> **tax\_rate\_id** `string` *required*
>
> The unique identifier (UUID) of the tax rate to delete
>
> **connection\_id** `string` *required*
>
> The accounting connection ID (UUID) associated with the tax rate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Accounting Vendor
>
> **Slug:** `RAMP_DELETE_ACCOUNTING_VENDORS`
>
> Tool to delete an accounting vendor from Ramp. Use when you need to remove a vendor from the accounting system.
>
> #### Input Parameters
>
> **vendor\_id** `string` *required*
>
> The unique identifier (UUID) of the vendor to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Custom Field Option
>
> **Slug:** `RAMP_DELETE_CUSTOM_FIELD_OPTION`
>
> Tool to delete a custom accounting field option from Ramp. Use when you need to remove a specific option from a custom accounting field.
>
> #### Input Parameters
>
> **field\_option\_id** `string` *required*
>
> The unique identifier (UUID) of the custom accounting field option to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Inventory Item Field
>
> **Slug:** `RAMP_DELETE_INVENTORY_ITEM_FIELD`
>
> Tool to delete the inventory item accounting field from Ramp. Use when you need to remove the inventory item field from the accounting connection. This uses the authenticated connection's context to identify which inventory item field to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Item Receipt
>
> **Slug:** `RAMP_DELETE_ITEM_RECEIPT`
>
> Delete an item receipt by its ID. Requires Ramp Plus. Returns an empty object after successful deletion (HTTP 204).
>
> #### Input Parameters
>
> **item\_receipt\_id** `string` *required*
>
> UUID of the item receipt to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Procurement Request
>
> **Slug:** `RAMP_DELETE_PROCUREMENT_REQUEST`
>
> Delete 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
>
> **unified\_request\_id** `string` *required*
>
> Unified procurement request ID, as returned by List Procurement Requests (not spend\_request\_id).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Purchase Order Line Item
>
> **Slug:** `RAMP_DELETE_PURCHASE_ORDER_LINE_ITEM`
>
> Delete one line item from an approved Ramp Plus purchase order.
>
> #### Input Parameters
>
> **line\_item\_id** `string` *required*
>
> Line item ID to delete.
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Users from Shared Limit
>
> **Slug:** `RAMP_DELETE_SPEND_ALLOCATION_DELETE_USERS`
>
> Tool to remove users from a shared spend limit in Ramp. Use when you need to revoke a user's access to a shared spending allocation.
>
> #### Input Parameters
>
> **user\_ids** `array` *required*
>
> List of user IDs (UUIDs) to remove from the shared limit
>
> **spend\_limit\_id** `string` *required*
>
> Unique identifier (UUID) of the shared spend limit to remove users from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Vendor
>
> **Slug:** `RAMP_DELETE_VENDOR`
>
> Delete a Ramp vendor by ID. A vendor cannot be deleted if it has associated transactions, bills, contracts, spend requests, or child vendors.
>
> #### Input Parameters
>
> **vendor\_id** `string` *required*
>
> The unique identifier (UUID) of the Ramp vendor to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook Subscription
>
> **Slug:** `RAMP_DELETE_WEBHOOK`
>
> Delete a Ramp webhook subscription by ID. The operation is irreversible and returns a success indicator when the request succeeds.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> The unique identifier (UUID) of the webhook subscription to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Bill Remittance Receipt
>
> **Slug:** `RAMP_DOWNLOAD_BILL_REMITTANCE_RECEIPT`
>
> Download the remittance receipt PDF for a Ramp bill.
>
> #### Input Parameters
>
> **bill\_id** `string` *required*
>
> Unique identifier of the bill
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch General Ledger Account
>
> **Slug:** `RAMP_FETCH_ACCOUNTING_ACCOUNT`
>
> Tool 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
>
> **gl\_account\_id** `string` *required*
>
> UUID of the general ledger account to retrieve
>
> **accounting\_connection\_id** `string`
>
> UUID of the accounting connection to filter the GL account. Required when fetching accounts associated with a specific accounting connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Accounting Vendor
>
> **Slug:** `RAMP_FETCH_ACCOUNTING_VENDOR`
>
> Tool 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
>
> **vendor\_id** `string` *required*
>
> UUID of the accounting vendor to retrieve
>
> **accounting\_connection\_id** `string`
>
> UUID of the accounting connection to filter the vendor. Used when fetching vendors associated with a specific accounting connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Custom Accounting Field
>
> **Slug:** `RAMP_FETCH_CUSTOM_ACCOUNTING_FIELD`
>
> Tool for fetching a custom accounting field.
>
> #### Input Parameters
>
> **field\_id** `string` *required*
>
> UUID of the custom accounting field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List General Ledger Accounts
>
> **Slug:** `RAMP_GET_ACCOUNTING_ACCOUNTS`
>
> Tool to list general ledger accounts from Ramp. Use when you need to retrieve GL accounts for accounting integration or transaction categorization.
>
> #### Input Parameters
>
> **code** `string`
>
> Filter by account code (e.g., '6410')
>
> **start** `string`
>
> The ID of the last entity of the previous page, used for pagination to get the next page
>
> **is\_active** `boolean`
>
> Filter by active status. If not provided, returns all accounts. If true, returns only active accounts. If false, returns only inactive accounts.
>
> **is\_synced** `boolean`
>
> Filter by sync status with the accounting system
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
>
> **remote\_id** `string`
>
> Filter by Remote/external ID from the ERP system
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch All Accounting Connections
>
> **Slug:** `RAMP_GET_ACCOUNTING_ALL_CONNECTIONS`
>
> Tool to fetch all accounting connections for the current Ramp business. Use when you need to view all accounting integrations, including both active and inactive connections.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Accounting Connection
>
> **Slug:** `RAMP_GET_ACCOUNTING_CONNECTION`
>
> Tool to fetch the current active accounting connection for a Ramp account. Use when you need to check the status, type, or configuration of the active accounting integration with providers like QuickBooks or NetSuite.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Accounting Connection By ID
>
> **Slug:** `RAMP_GET_ACCOUNTING_CONNECTION_BY_ID`
>
> Tool to fetch a specific accounting connection by ID from Ramp. Use when you need to retrieve detailed information about a particular accounting integration.
>
> #### Input Parameters
>
> **connection\_id** `string` *required*
>
> UUID of the accounting connection to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Custom Accounting Fields
>
> **Slug:** `RAMP_GET_ACCOUNTING_FIELDS`
>
> Tool 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
>
> **start** `string`
>
> The ID of the last entity of the previous page, used for pagination to get the next page
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Accounting Tax Code
>
> **Slug:** `RAMP_GET_ACCOUNTING_TAX_CODE`
>
> Fetch 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
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required for an inactive connection; otherwise defaults to the current accounting connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounting Vendors
>
> **Slug:** `RAMP_GET_ACCOUNTING_VENDORS`
>
> Tool 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
>
> **cursor** `string`
>
> The ID of the last entity from the previous page, used for pagination to get the next page of results. Ramp uses cursor-based pagination for consistent results.
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Transactions
>
> **Slug:** `RAMP_GET_ALL_TRANSACTIONS`
>
> List a page of Ramp transactions, with optional filters and sorting. Pagination information can be used to request subsequent pages.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **state** `string`
>
> Filter by transaction state. If set to 'ALL', all transactions including 'DECLINED' will be listed
>
> **card\_id** `string`
>
> Filter by physical card UUID
>
> **to\_date** `string`
>
> Filter for transactions with user\_transaction\_time before the given date (ISO 8601 datetime, default: today)
>
> **trip\_id** `string`
>
> Filter for trip UUID
>
> **user\_id** `string`
>
> Filter by user UUID
>
> **limit\_id** `string`
>
> Filter by limit UUID
>
> **entity\_id** `string`
>
> Filter transactions by business entity UUID
>
> **from\_date** `string`
>
> Filter for transactions with user\_transaction\_time after the given date (ISO 8601 datetime)
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **max\_amount** `string`
>
> Filter for transactions with amount smaller than given amount (USD)
>
> **min\_amount** `string`
>
> Filter for transactions with amount larger than given amount (USD)
>
> **sync\_ready** `boolean`
>
> Filter for transactions that are coded with accounting fields and ready to sync to ERP systems
>
> **location\_id** `string`
>
> Filter by location UUID
>
> **merchant\_id** `string`
>
> Filter by merchant UUID
>
> **sync\_status** `string`
>
> Filter for transactions by sync status. Supersedes sync\_ready and has\_no\_sync\_commits if set
>
> **statement\_id** `string`
>
> Filter by statement UUID
>
> **synced\_after** `string`
>
> Filter for transactions synced after the given date (ISO 8601 datetime)
>
> **department\_id** `string`
>
> Filter by department UUID
>
> **requires\_memo** `boolean`
>
> Filters for transactions which require a memo but do not have one (can only be set to true)
>
> **sk\_category\_id** `string`
>
> Filter by Ramp category code (integer)
>
> **approval\_status** `string`
>
> Filter by transaction approval status
>
> **spend\_program\_id** `string`
>
> Filter by spend program UUID
>
> **order\_by\_date\_asc** `boolean`
>
> Sort transactions by user\_transaction\_date in ascending order
>
> **order\_by\_date\_desc** `boolean`
>
> Sort transactions by user\_transaction\_date in descending order
>
> **has\_no\_sync\_commits** `boolean`
>
> Filter for transactions that have not been synced to ERP systems yet
>
> **order\_by\_amount\_asc** `boolean`
>
> Sort transactions by amount in ascending order
>
> **order\_by\_amount\_desc** `boolean`
>
> Sort transactions by amount in descending order
>
> **include\_merchant\_data** `boolean`
>
> Include all purchase data provided by the merchant
>
> **awaiting\_approval\_by\_user\_id** `string`
>
> Filter for transactions awaiting approval by a specific user UUID
>
> **accounting\_field\_selection\_id** `string`
>
> Filter transactions by accounting field selection UUID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bank Account
>
> **Slug:** `RAMP_GET_BANK_ACCOUNT`
>
> Get one connected Ramp bank account by UUID. Obtain bank\_account\_id from List Bank Accounts. Returns account metadata, connection provider, and ACH-detail availability. Requires bank\_accounts:read.
>
> #### Input Parameters
>
> **bank\_account\_id** `string` *required*
>
> Bank account UUID; obtain from List Bank Accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Banking Balance History
>
> **Slug:** `RAMP_GET_BANKING_BALANCE_HISTORY`
>
> Get 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
>
> **start** `string`
>
> Opaque start cursor from the previous response's page.next URL.
>
> **end\_date** `string`
>
> Include balances on or before this ISO 8601 date (YYYY-MM-DD).
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **account\_id** `string` *required*
>
> Banking account ID; obtain from List Banking Accounts.
>
> **start\_date** `string`
>
> Include balances on or after this ISO 8601 date (YYYY-MM-DD).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bill
>
> **Slug:** `RAMP_GET_BILL`
>
> Fetch one Ramp bill by ID, including its coding, line items, and payment.
>
> #### Input Parameters
>
> **bill\_id** `string` *required*
>
> UUID of the bill to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Business
>
> **Slug:** `RAMP_GET_BUSINESS`
>
> Fetch the connected Ramp company's information, including names, billing address and approved credit limit. Requires business:read; no business ID is needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Business Balance
>
> **Slug:** `RAMP_GET_BUSINESS_BALANCE`
>
> Fetch the current Ramp business's balances, available card and flex limits, overall spending limit, and billing dates. No business ID or filters are needed. Amount objects include the currency and minor-unit conversion rate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Card
>
> **Slug:** `RAMP_GET_CARD`
>
> Tool for retrieving detailed information about a specific card. Returns comprehensive card details including spending limits, cardholder info, and fulfillment status. Use this to get complete card profile for analysis or troubleshooting.
>
> #### Input Parameters
>
> **card\_id** `string` *required*
>
> The ID of the card to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Card Vault Resource
>
> **Slug:** `RAMP_GET_CARD_VAULT_RESOURCE`
>
> Tool to fetch a card's sensitive details from the vault. Requires vault API access. Use when you need to retrieve PAN or CVV for a specific card. This endpoint uses a separate vault base URL.
>
> #### Input Parameters
>
> **card\_id** `string` *required*
>
> The unique identifier of the card to fetch sensitive details for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Cashback
>
> **Slug:** `RAMP_GET_CASHBACK`
>
> Fetch one Ramp cashback payment by ID, including its amount and sync status. Obtain cashback\_id from List Cashback Payments. Requires cashbacks:read.
>
> #### Input Parameters
>
> **cashback\_id** `string` *required*
>
> Cashback payment ID; obtain from List Cashback Payments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Field Option
>
> **Slug:** `RAMP_GET_CUSTOM_FIELD_OPTION`
>
> Tool to fetch a custom accounting field option by its ID. Use when you need to retrieve details about a specific custom accounting field option from Ramp's accounting integration.
>
> #### Input Parameters
>
> **field\_option\_id** `string` *required*
>
> UUID of the custom accounting field option to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Form Collection Response
>
> **Slug:** `RAMP_GET_CUSTOM_FORM_COLLECTION_RESPONSE`
>
> Fetch 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
>
> **custom\_form\_collection\_response\_id** `string` *required*
>
> Custom form collection response ID from procurement, vendor or purchase-order custom-form metadata. This is a response ID, not a template or form ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Department
>
> **Slug:** `RAMP_GET_DEPARTMENT`
>
> Retrieve a specific Ramp department by ID, returning its ID and name.
>
> #### Input Parameters
>
> **department\_id** `string` *required*
>
> The ID of the department to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Draft Bill (Beta)
>
> **Slug:** `RAMP_GET_DRAFT_BILL`
>
> Beta: retrieve one Ramp draft bill by its unique identifier.
>
> #### Input Parameters
>
> **draft\_bill\_id** `string` *required*
>
> Unique identifier of the draft bill to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Entity
>
> **Slug:** `RAMP_GET_ENTITY`
>
> Get one Ramp business entity by UUID, including accounts and locations. Obtain entity\_id from List Entities. Optionally hide inactive entities or include custom record field values. Requires entities:read.
>
> #### Input Parameters
>
> **entity\_id** `string` *required*
>
> Business entity UUID; obtain from List Entities.
>
> **hide\_inactive** `boolean`
>
> Hide inactive entities (default false).
>
> **include\_custom\_field\_values** `boolean`
>
> Include custom record field values (default false).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Inventory Item Field
>
> **Slug:** `RAMP_GET_INVENTORY_ITEM_FIELD`
>
> Tool to fetch inventory item accounting field for the current accounting connection. Use when you need to retrieve the inventory item field configuration from the connected ERP system.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Item Receipt
>
> **Slug:** `RAMP_GET_ITEM_RECEIPT`
>
> Fetch an item receipt by UUID, including its purchase order, line items and document URLs. Requires Ramp Plus.
>
> #### Input Parameters
>
> **item\_receipt\_id** `string` *required*
>
> UUID of the item receipt to fetch; discover IDs with List Item Receipts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Location
>
> **Slug:** `RAMP_GET_LOCATION`
>
> Fetch one Ramp location by its UUID, returning its name and business entity ID. Use the locations list endpoint to discover the location ID. Requires locations:read.
>
> #### Input Parameters
>
> **location\_id** `string` *required*
>
> Unique identifier (UUID) of the location; obtain it by listing locations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Memo
>
> **Slug:** `RAMP_GET_MEMO`
>
> Tool to fetch a transaction memo. Use when you need to retrieve the memo text associated with a specific transaction.
>
> #### Input Parameters
>
> **transaction\_id** `string` *required*
>
> Unique identifier of the transaction for which to retrieve the memo (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Procurement Request
>
> **Slug:** `RAMP_GET_PROCUREMENT_REQUEST`
>
> Retrieve 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
>
> **unified\_request\_id** `string` *required*
>
> Unified procurement request ID, as returned by List Procurement Requests (not spend\_request\_id).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Purchase Order
>
> **Slug:** `RAMP_GET_PURCHASE_ORDER`
>
> Fetch a Ramp Plus purchase order and its detailed line items.
>
> #### Input Parameters
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Receipt
>
> **Slug:** `RAMP_GET_RECEIPT`
>
> Fetch a Ramp receipt by UUID, returning a temporary image URL and optional structured OCR data.
>
> #### Input Parameters
>
> **receipt\_id** `string` *required*
>
> UUID of the existing receipt to retrieve; discover IDs with List Receipts.
>
> **include\_ocr\_data** `boolean`
>
> Include structured OCR data, including currency code, line items and taxes. Omitted by default.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reimbursement Details
>
> **Slug:** `RAMP_GET_REIMBURSEMENT`
>
> Retrieve details of a specific reimbursement, including amount, status, user information, accounting details, and receipts, for approval workflows or analysis.
>
> #### Input Parameters
>
> **reimbursement\_id** `string` *required*
>
> ID of the reimbursement to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Spend Limit
>
> **Slug:** `RAMP_GET_SPEND_LIMIT`
>
> Tool to fetch detailed information about a specific spend limit. Use when you need to retrieve comprehensive limit details including balance, restrictions, linked cards, and users.
>
> #### Input Parameters
>
> **spend\_limit\_id** `string` *required*
>
> The unique identifier (UUID) of the spend limit to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Spend Program
>
> **Slug:** `RAMP_GET_SPEND_PROGRAM`
>
> Retrieve one Ramp spend program by ID, including restrictions and request forms.
>
> #### Input Parameters
>
> **spend\_program\_id** `string` *required*
>
> The ID of the spend program to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Statement
>
> **Slug:** `RAMP_GET_STATEMENT`
>
> Retrieve a statement in JSON or request PDF or CSV format. For PDF and CSV requests, returns the statement ID and a download URL when provided in the response Location header.
>
> #### Input Parameters
>
> **format** `string ("json" | "pdf" | "csv")`
>
> Format of the statement: json, pdf, csv
>
> **statement\_id** `string` *required*
>
> ID of the statement to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Transaction Details
>
> **Slug:** `RAMP_GET_TRANSACTION`
>
> Tool for retrieving complete details of a specific transaction. Includes merchant details, receipts, accounting codes, and dispute information.
>
> #### Input Parameters
>
> **transaction\_id** `string` *required*
>
> ID of the transaction to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Transfer
>
> **Slug:** `RAMP_GET_TRANSFER`
>
> Fetch 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
>
> **transfer\_id** `string` *required*
>
> Transfer identifier; obtain from List Transfer Payments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Trip
>
> **Slug:** `RAMP_GET_TRIP`
>
> Fetch an existing Ramp trip by UUID, including locations, spend events and totals.
>
> #### Input Parameters
>
> **trip\_id** `string` *required*
>
> UUID of the existing trip to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `RAMP_GET_USER`
>
> Tool to retrieve detailed information about a specific Ramp user by their ID. Use when you need complete user profile information including role, status, department, and custom fields.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The unique identifier (UUID) of the user to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Users Deferred Status
>
> **Slug:** `RAMP_GET_USERS_DEFERRED_STATUS`
>
> Tool for fetching the status of a deferred user task. Use when you need to check the progress or outcome of asynchronous user operations like user creation.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Unique identifier of the deferred task to retrieve status for (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Vendor Details
>
> **Slug:** `RAMP_GET_VENDOR`
>
> Tool for retrieving detailed information about a specific vendor. Returns comprehensive vendor details including spending totals, category, and contact information. Use this to get complete vendor profile for analysis or updates.
>
> #### Input Parameters
>
> **vendor\_id** `string` *required*
>
> The ID of the vendor to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Vendor Bank Account
>
> **Slug:** `RAMP_GET_VENDOR_BANK_ACCOUNT`
>
> Fetch 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
>
> **vendor\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor that owns the account.
>
> **bank\_account\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor bank account to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Vendor Contact
>
> **Slug:** `RAMP_GET_VENDOR_CONTACT`
>
> Fetch one vendor contact by vendor ID and contact ID. Returns the contact's email, nullable first and last names and phone number, and whether it is the default contact. Use List Vendor Contacts to find IDs.
>
> #### Input Parameters
>
> **vendor\_id** `string` *required*
>
> UUID of the vendor that owns the contact.
>
> **vendor\_contact\_id** `string` *required*
>
> UUID of the vendor contact, obtained from List Vendor Contacts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook
>
> **Slug:** `RAMP_GET_WEBHOOK`
>
> Tool to retrieve detailed information about a specific webhook subscription by ID. Use when you need to check webhook configuration, status, or event types.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> The unique identifier of the webhook subscription to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Hold Bill
>
> **Slug:** `RAMP_HOLD_BILL`
>
> Beta: place a Ramp bill on hold, blocking all payment rails and descheduling payments.
>
> #### Input Parameters
>
> **reason** `string`
>
> Optional reason for placing the bill on hold.
>
> **bill\_id** `string` *required*
>
> UUID of the bill to place on hold.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Hold Vendor
>
> **Slug:** `RAMP_HOLD_VENDOR`
>
> Block 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
>
> **reason** `string`
>
> Optional reason for placing the vendor on hold. May be null.
>
> **vendor\_id** `string` *required*
>
> Unique identifier of the vendor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Issue Virtual Card
>
> **Slug:** `RAMP_ISSUE_VIRTUAL_CARD`
>
> Request asynchronous issuance of a virtual card for a user, with optional spending limits and restrictions. Returns a deferred task identifier and status for tracking the operation.
>
> #### Input Parameters
>
> **memo** `string`
>
> Memo for the card creation
>
> **user\_id** `string` *required*
>
> User ID to issue the card to
>
> **display\_name** `string`
>
> Display name for the card
>
> **card\_program\_id** `string`
>
> Card program ID to use for the card
>
> **spending\_restrictions** `object`
>
> Spending restrictions for the card
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounting Field Option Filter Rules
>
> **Slug:** `RAMP_LIST_ACCOUNTING_FIELD_OPTION_FILTER_RULES`
>
> List 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
>
> **start** `string`
>
> ID of the last entity of the previous page, used to get the next page.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100. Defaults to 20.
>
> **target\_field\_remote\_id** `string`
>
> Filter by target field remote ID.
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required when the filter rules belong to an inactive accounting connection.
>
> **target\_field\_option\_remote\_id** `string`
>
> Filter by target field option remote ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounting Inventory Item Options
>
> **Slug:** `RAMP_LIST_ACCOUNTING_INVENTORY_ITEM_OPTIONS`
>
> Tool to list accounting inventory item options from Ramp. Use when you need to retrieve inventory items for accounting integration or transaction categorization.
>
> #### Input Parameters
>
> **code** `string`
>
> Filter by code
>
> **start** `string`
>
> The ID of the last entity of the previous page, used for pagination to get the next page
>
> **is\_active** `boolean`
>
> Filter by active status. If not provided, returns all objects. If true, returns only active objects. If false, returns only inactive objects.
>
> **is\_synced** `boolean`
>
> Filter by sync status with the accounting system
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
>
> **remote\_id** `string`
>
> Filter by Remote/external ID from the ERP system
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounting Tax Code Options
>
> **Slug:** `RAMP_LIST_ACCOUNTING_TAX_CODE_OPTIONS`
>
> List one page of accounting tax code options, including external tax rate IDs and entity availability. Specify accounting\_connection\_id for an inactive connection. Follow page.next using its start cursor to retrieve subsequent pages.
>
> #### Input Parameters
>
> **code** `string`
>
> Filter by code.
>
> **start** `string`
>
> ID of the last entity on the previous page, used to retrieve the next page.
>
> **is\_active** `boolean`
>
> Filter by active status; omit to return both active and inactive options.
>
> **is\_synced** `boolean`
>
> Filter by whether the option is synced.
>
> **page\_size** `integer`
>
> Results per page, between 2 and 100; defaults to 20.
>
> **remote\_id** `string`
>
> Filter by remote/external ID.
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required when querying an inactive accounting connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accounting Tax Rates
>
> **Slug:** `RAMP_LIST_ACCOUNTING_TAX_RATES`
>
> Tool 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
>
> **start** `string`
>
> The ID of the last entity of the previous page, used for pagination to get the next page
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Audit Log Events
>
> **Slug:** `RAMP_LIST_AUDIT_LOG_EVENTS`
>
> List 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
>
> **start** `string`
>
> Opaque last-entity ID from page.next's start query parameter; pass unchanged with the same filters.
>
> **to\_date** `string`
>
> Events created at or before this ISO 8601 date-time (inclusive).
>
> **user\_ids** `array`
>
> Filter events attributed to these user UUIDs. Sent comma-separated.
>
> **from\_date** `string`
>
> Events created at or after this ISO 8601 date-time (inclusive).
>
> **object\_id** `string`
>
> Referenced object UUID. Also supply resource\_name.
>
> **page\_size** `integer`
>
> Results per page, 2-100 (default 20).
>
> **agent\_names** `array`
>
> Customer-visible agent labels that executed the action. Sent comma-separated.
>
> **event\_types** `array`
>
> Exact Ramp audit event type labels, for example 'User login', 'Created card', or 'Test'. Sent comma-separated; use labels from Ramp's audit log event catalog.
>
> **resource\_name** `string ("Accounting rule group" | "Approvals" | "Bill payment" | "Bill template" | "Card" | "Cash Manager recommendation" | "Fixed asset class" | "Fixed asset" | "Forecast custom input" | "Fund request" | "Investment account" | "Legal entity" | "Managed portfolio transfer" | "Payment run" | "Reimbursement" | "SFTP Configurations" | "Separation of duties" | "Spend allocation" | "Spend event" | "Spend program" | "Transaction" | "Travel (Booking request)" | "Travel (Trip)" | "Treasury account" | "User" | "Vendor / Merchant" | "WBX Policy" | "WBX Request" | "Wallet automation policy" | "Wallet transfer" | "Workflow (Base)" | "Workflow")`
>
> Referenced resource name. Also supply object\_id.
>
> **event\_actor\_types** `array`
>
> Filter by actor types. Sent comma-separated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bank Accounts
>
> **Slug:** `RAMP_LIST_BANK_ACCOUNTS`
>
> List 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
>
> **start** `string`
>
> ID of the last entity of the previous page; use start from page.next.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **connection\_provider** `string ("finicity" | "manual" | "plaid" | "ramp_brokerage" | "ramp_wallet" | "teller")`
>
> Filter bank accounts by connection provider.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Banking Accounts
>
> **Slug:** `RAMP_LIST_BANKING_ACCOUNTS`
>
> List the business's Ramp checking, brokerage, and investment accounts. Returns one page of account identifiers, types, and display names. Requires treasury:read. To continue, pass the start query parameter from page.next.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bills
>
> **Slug:** `RAMP_LIST_BILLS`
>
> List Ramp bills using payment, status, accounting, date, and amount filters.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last bill from the previous page.
>
> **entity\_id** `string`
>
> Filter by business entity UUID.
>
> **page\_size** `integer`
>
> Results per page, from 2 through 100.
>
> **remote\_id** `string`
>
> Filter by exact client-side ID.
>
> **vendor\_id** `string`
>
> Filter by vendor UUID.
>
> **max\_amount** `string`
>
> Maximum bill amount in major currency units.
>
> **min\_amount** `string`
>
> Minimum bill amount in major currency units.
>
> **payment\_id** `string`
>
> Filter by payment UUID.
>
> **sync\_ready** `boolean`
>
> Return only bills ready or not ready to sync to the ERP.
>
> **to\_paid\_at** `string`
>
> Return bills paid on or before this ISO 8601 datetime.
>
> **is\_archived** `boolean`
>
> When true, return archived bills instead of active bills.
>
> **sync\_status** `string ("BILL_AND_PAYMENT_SYNCED" | "BILL_SYNCED" | "NOT_SYNCED")`
>
> Filter by ERP sync status.
>
> **to\_due\_date** `string`
>
> Return bills due on or before this ISO 8601 datetime.
>
> **from\_paid\_at** `string`
>
> Return bills paid on or after this ISO 8601 datetime.
>
> **draft\_bill\_id** `string`
>
> Filter by exact source draft bill UUID.
>
> **from\_due\_date** `string`
>
> Return bills due on or after this ISO 8601 datetime.
>
> **to\_created\_at** `string`
>
> Return bills created on or before this ISO 8601 datetime.
>
> **invoice\_number** `string`
>
> Filter by exact invoice number.
>
> **payment\_method** `string ("ACH" | "CARD" | "CHECK" | "CRYPTO_WALLET_TRANSFER" | "DOMESTIC_WIRE" | "INTERNATIONAL" | "LOCAL_BANK_TRANSFER" | "ONE_TIME_CARD" | "ONE_TIME_CARD_DELIVERY" | "PAID_MANUALLY" | "SWIFT")`
>
> Filter by payment method.
>
> **payment\_status** `string ("OPEN" | "PAID")`
>
> Filter by bill payment status.
>
> **to\_issued\_date** `string`
>
> Return bills issued on or before this ISO 8601 datetime.
>
> **approval\_status** `string ("APPROVED" | "INITIALIZED" | "PENDING" | "REJECTED" | "TERMINATED")`
>
> Filter by bill approval status.
>
> **from\_created\_at** `string`
>
> Return bills created on or after this ISO 8601 datetime.
>
> **to\_payment\_date** `string`
>
> Return non-card bills with payment dates on or before this YYYY-MM-DD date.
>
> **from\_issued\_date** `string`
>
> Return bills issued on or after this ISO 8601 datetime.
>
> **status\_summaries** `array`
>
> Filter by one or more status summaries; values are sent to Ramp as a comma-separated list.
>
> **from\_payment\_date** `string`
>
> Return non-card bills with payment dates on or after this YYYY-MM-DD date.
>
> **purchase\_order\_id** `string`
>
> Filter by matched purchase order UUID.
>
> **is\_payment\_sync\_ready** `boolean`
>
> Filter by payment accounting export readiness.
>
> **payment\_details\_missing** `boolean`
>
> When true, return only bills missing payment details.
>
> **is\_accounting\_sync\_enabled** `boolean`
>
> Filter by whether bills are configured to sync to the ERP.
>
> **customer\_friendly\_payment\_id** `string`
>
> Filter by exact customer-facing payment ID.
>
> **accounting\_field\_selection\_id** `string`
>
> Filter by an accounting field option UUID used to code a bill.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Cards
>
> **Slug:** `RAMP_LIST_CARDS`
>
> Tool for listing all cards across the organization with optional filters. Returns card details including spending limits, cardholder info, and state. Use this to analyze card distribution, monitor card states, or find specific cards.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **user\_id** `string`
>
> Filter by card owner UUID
>
> **entity\_id** `string`
>
> Filter by business entity UUID
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **display\_name** `string`
>
> Filter by display name
>
> **is\_activated** `boolean`
>
> Filter only for activated cards. Defaults to True if not specified
>
> **is\_terminated** `boolean`
>
> Filter only for terminated cards. Defaults to False if not specified
>
> **card\_program\_id** `string`
>
> Filter by card program UUID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Cashbacks
>
> **Slug:** `RAMP_LIST_CASHBACKS`
>
> List 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
>
> **start** `string`
>
> Opaque ID/cursor from the previous page's page.next start query parameter.
>
> **to\_date** `string`
>
> Cashbacks on or before this ISO8601 datetime.
>
> **entity\_id** `string`
>
> Filter cashbacks by business entity UUID.
>
> **from\_date** `string`
>
> Cashbacks on or after this ISO8601 datetime.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **sync\_ready** `boolean`
>
> Filter cashbacks ready to sync (no pending syncs and completed).
>
> **sync\_status** `string ("NOT_SYNC_READY" | "SYNCED" | "SYNC_READY")`
>
> Filter by sync status. Supersedes sync\_ready if provided.
>
> **statement\_id** `string`
>
> Filter cashbacks included in the specified statement UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Child Vendors
>
> **Slug:** `RAMP_LIST_CHILD_VENDORS`
>
> List 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
>
> **start** `string`
>
> ID of the last entity of the previous page.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **vendor\_id** `string` *required*
>
> ID of the parent vendor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Departments
>
> **Slug:** `RAMP_LIST_DEPARTMENTS`
>
> List Ramp departments with pagination, returning department IDs and names.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Draft Bills (Beta)
>
> **Slug:** `RAMP_LIST_DRAFT_BILLS`
>
> Beta: list Ramp draft bills with filters and cursor pagination.
>
> #### Input Parameters
>
> **start** `string`
>
> ID from the previous page's page.next URL.
>
> **entity\_id** `string`
>
> Filter draft bills by business entity UUID.
>
> **page\_size** `integer`
>
> Number of results to return, from 2 to 100.
>
> **remote\_id** `string`
>
> Filter by exact client-side remote ID.
>
> **vendor\_id** `string`
>
> Filter draft bills by vendor UUID.
>
> **to\_due\_date** `string`
>
> Return drafts due on or before this ISO 8601 datetime.
>
> **from\_due\_date** `string`
>
> Return drafts due on or after this ISO 8601 datetime.
>
> **to\_created\_at** `string`
>
> Return drafts created on or before this ISO 8601 datetime.
>
> **invoice\_number** `string`
>
> Filter by exact invoice number.
>
> **to\_issued\_date** `string`
>
> Return drafts issued on or before this ISO 8601 datetime.
>
> **from\_created\_at** `string`
>
> Return drafts created on or after this ISO 8601 datetime.
>
> **from\_issued\_date** `string`
>
> Return drafts issued on or after this ISO 8601 datetime.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Entities
>
> **Slug:** `RAMP_LIST_ENTITIES`
>
> List 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
>
> **start** `string`
>
> ID of the last entity of the previous page.
>
> **currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDG" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")`
>
> Filter by currency of the entity.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **is\_primary** `boolean`
>
> Filter to include only primary or non-primary entities.
>
> **entity\_name** `string`
>
> Filter entities by name.
>
> **hide\_inactive** `boolean`
>
> Hide inactive entities. Defaults to false.
>
> **include\_deleted\_accounts** `boolean`
>
> Include deleted accounts. Boolean query flag; omit to use the provider default.
>
> **include\_custom\_field\_values** `boolean`
>
> Include custom record field values. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Item Receipts
>
> **Slug:** `RAMP_LIST_ITEM_RECEIPTS`
>
> List one page of item receipts, optionally filtered by entity or purchase order. Requires Ramp Plus. Returns receipt details, line items and native page.next. For the next page, pass the start query value from page.next with the same filters.
>
> #### Input Parameters
>
> **start** `string`
>
> Last entity ID from the previous page; use start from page.next unchanged.
>
> **entity\_id** `string`
>
> Associated business entity UUID.
>
> **page\_size** `integer`
>
> Results per page, between 2 and 100 (default 20).
>
> **include\_archived** `boolean`
>
> Include archived item receipts; defaults to false.
>
> **purchase\_order\_id** `string`
>
> Associated purchase order UUID.
>
> **purchase\_order\_line\_item\_id** `string`
>
> Associated purchase order line item UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Locations
>
> **Slug:** `RAMP_LIST_LOCATIONS`
>
> List one page of Ramp locations, optionally filtered by business entity. Returns location IDs, names, entity IDs, and the native page.next URL. Use its start query parameter to request the next page.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page; pass unchanged to retrieve the next page.
>
> **entity\_id** `string`
>
> Filter by associated business entity UUID.
>
> **page\_size** `integer`
>
> Number of results per page (2-100; default 20).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Memos
>
> **Slug:** `RAMP_LIST_MEMOS`
>
> Tool for listing memos associated with transactions in your Ramp organization. Returns memo details with support for filtering by card, user, department, location, manager, merchant, and date range.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **card\_id** `string`
>
> Filter memos by card UUID
>
> **to\_date** `string`
>
> Filter memos for transactions before this date (ISO 8601 format)
>
> **user\_id** `string`
>
> Filter memos by user UUID
>
> **from\_date** `string`
>
> Filter memos for transactions after this date (ISO 8601 format)
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **manager\_id** `string`
>
> Filter memos by manager UUID
>
> **location\_id** `string`
>
> Filter memos by location UUID
>
> **merchant\_id** `string`
>
> Filter memos by merchant UUID
>
> **department\_id** `string`
>
> Filter memos by department UUID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Merchants
>
> **Slug:** `RAMP_LIST_MERCHANTS`
>
> List 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
>
> **start** `string`
>
> ID of the last entity of the previous page; use the start query parameter from page.next unchanged.
>
> **page\_size** `integer`
>
> Number of results per page (2-100; default 20).
>
> **merchant\_url** `string`
>
> Filter merchants by URL or domain after normalization.
>
> **merchant\_name** `string`
>
> Filter merchants by a case-sensitive display name prefix.
>
> **transaction\_to\_date** `string`
>
> Filter by transactions occurring (user\_transaction\_time) on or before this date-time (ISO 8601).
>
> **transaction\_from\_date** `string`
>
> Filter by transactions occurring (user\_transaction\_time) on or after this date-time (ISO 8601).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Procurement Request Attachments
>
> **Slug:** `RAMP_LIST_PROCUREMENT_REQUEST_ATTACHMENTS`
>
> List 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
>
> **unified\_request\_id** `string` *required*
>
> Unified procurement request ID from List Procurement Requests (not spend\_request\_id).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Procurement Requests
>
> **Slug:** `RAMP_LIST_PROCUREMENT_REQUESTS`
>
> List 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
>
> **start** `string`
>
> Opaque pagination cursor from the previous page.next URL's start parameter.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **entity\_ids** `array`
>
> Filter by entity IDs.
>
> **max\_amount** `string`
>
> Inclusive maximum amount, as a decimal string or number.
>
> **min\_amount** `string`
>
> Inclusive minimum amount, as a decimal string or number.
>
> **location\_ids** `array`
>
> Filter by location IDs.
>
> **to\_created\_at** `string`
>
> Return requests created on or before this ISO 8601 datetime.
>
> **department\_ids** `array`
>
> Filter by department IDs.
>
> **owner\_user\_ids** `array`
>
> Filter by owner user IDs.
>
> **from\_created\_at** `string`
>
> Return requests created on or after this ISO 8601 datetime.
>
> **include\_deleted** `boolean`
>
> Show deleted requests instead of active requests.
>
> **request\_statuses** `array`
>
> Filter by request statuses; PENDING selects pending requests.
>
> **spend\_program\_ids** `array`
>
> Filter by spend program IDs.
>
> **spend\_request\_types** `array`
>
> Filter by persisted spend request types.
>
> **unified\_spend\_request\_types** `array`
>
> Filter by unified spend request classifications.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Purchase Orders
>
> **Slug:** `RAMP_LIST_PURCHASE_ORDERS`
>
> List and filter Ramp Plus purchase orders using cursor pagination.
>
> #### Input Parameters
>
> **start** `string`
>
> Last entity ID from the previous page's next URL.
>
> **entity\_id** `string`
>
> Filter by associated business entity ID.
>
> **page\_size** `integer`
>
> Number of results per page, from 2 to 100.
>
> **remote\_id** `string`
>
> Filter by exact accounting provider remote ID.
>
> **external\_id** `string`
>
> Filter by exact client-side external ID.
>
> **to\_created\_at** `string`
>
> Return purchase orders created before this ISO 8601 timestamp.
>
> **receipt\_status** `string ("FULLY_RECEIVED" | "NOT_RECEIVED" | "OVER_RECEIVED" | "PARTIALLY_RECEIVED")`
>
> Filter by receipt status.
>
> **creation\_source** `string ("ACCOUNTING_PROVIDER" | "DEVELOPER_API" | "EXTERNAL_IMPORT" | "RAMP")`
>
> Filter by purchase order creation source.
>
> **from\_created\_at** `string`
>
> Return purchase orders created after this ISO 8601 timestamp.
>
> **include\_archived** `boolean`
>
> Whether archived purchase orders should be included.
>
> **spend\_request\_id** `string`
>
> Filter by associated spend request ID.
>
> **three\_way\_match\_enabled** `boolean`
>
> Filter by whether three-way matching is enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Receipt Integration Opt Out Emails
>
> **Slug:** `RAMP_LIST_RECEIPT_INTEGRATION_OPT_OUT_EMAILS`
>
> List 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
>
> **id** `string`
>
> Optional opt-out UUID query value. Filtering is not guaranteed; check returned entries.
>
> **email** `string`
>
> Optional email query value. Ramp may ignore it and return the entire list; check returned entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Receipts
>
> **Slug:** `RAMP_LIST_RECEIPTS`
>
> List 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
>
> **start** `string`
>
> ID of the last entity on the previous page; pass the start query parameter from page.next unchanged.
>
> **to\_date** `string`
>
> Filter transactions with user\_transaction\_time before this ISO 8601 date-time.
>
> **from\_date** `string`
>
> Filter transactions with user\_transaction\_time after this ISO 8601 date-time.
>
> **page\_size** `integer`
>
> Results per page, 2-100 (default 20).
>
> **created\_after** `string`
>
> Filter receipts created after this ISO 8601 date-time.
>
> **created\_before** `string`
>
> Filter receipts created before this ISO 8601 date-time.
>
> **transaction\_id** `string`
>
> Filter receipts for a specific transaction UUID.
>
> **include\_ocr\_data** `boolean`
>
> Include structured receipt OCR currency, line items and taxes.
>
> **reimbursement\_id** `string`
>
> Filter receipts for a specific reimbursement UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Reimbursements
>
> **Slug:** `RAMP_LIST_REIMBURSEMENTS`
>
> List reimbursements with filtering options. Returns reimbursement details including amounts, status, and associated entities for expense analysis and approval workflows.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **to\_date** `string`
>
> Filter reimbursements created before this date (ISO 8601 datetime)
>
> **trip\_id** `string`
>
> Filter reimbursements associated with a specific trip UUID
>
> **user\_id** `string`
>
> Filter by user UUID
>
> **direction** `string`
>
> Filter by direction (BUSINESS\_TO\_USER default, USER\_TO\_BUSINESS for repayments)
>
> **entity\_id** `string`
>
> Filter reimbursements by business entity UUID
>
> **from\_date** `string`
>
> Filter reimbursements created after this date (ISO 8601 datetime)
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **sync\_ready** `boolean`
>
> Filter reimbursements that are ready to sync to ERP systems
>
> **sync\_status** `string`
>
> Filter by sync status. Supersedes has\_no\_sync\_commits and sync\_ready
>
> **synced\_after** `string`
>
> Filter reimbursements synced after this date (ISO 8601 datetime)
>
> **updated\_after** `string`
>
> Filter reimbursements updated after this date (ISO 8601 datetime)
>
> **to\_submitted\_at** `string`
>
> Filter reimbursements submitted before this date (ISO 8601 datetime)
>
> **from\_submitted\_at** `string`
>
> Filter reimbursements submitted after this date (ISO 8601 datetime)
>
> **has\_no\_sync\_commits** `boolean`
>
> Filter reimbursements that haven't been synced to ERP systems
>
> **to\_transaction\_date** `string`
>
> Filter by underlying transaction date (before this date, ISO 8601 datetime)
>
> **from\_transaction\_date** `string`
>
> Filter by underlying transaction date (after this date, ISO 8601 datetime)
>
> **awaiting\_approval\_by\_user\_id** `string`
>
> Filter for reimbursements awaiting approval by a specific user UUID
>
> **accounting\_field\_selection\_id** `string`
>
> Filter reimbursements by accounting field selection UUID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Repayments
>
> **Slug:** `RAMP_LIST_REPAYMENTS`
>
> List 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
>
> **start** `string`
>
> Opaque start query parameter from the previous page.next URL.
>
> **user\_id** `string`
>
> Filter repayments by user UUID.
>
> **entity\_id** `string`
>
> Filter repayments by business entity UUID.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **sync\_status** `string ("IN_PROGRESS" | "MARKED_CANCELED" | "NOT_STARTED" | "SYNC_FAILURE" | "SYNC_SUCCESS")`
>
> Latest repayment accounting sync status; excludes repayments with no sync.
>
> **to\_repaid\_at** `string`
>
> Repaid before this ISO8601 datetime; returns only completed repayments.
>
> **from\_repaid\_at** `string`
>
> Repaid at or after this ISO8601 datetime; returns only completed repayments.
>
> **funding\_methods** `array`
>
> Filter by funding methods; sent as a comma-separated list.
>
> **original\_transaction\_id** `string`
>
> Filter by the UUID of the original transaction.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Roles
>
> **Slug:** `RAMP_LIST_ROLES`
>
> List the business's custom roles and their product capabilities. Returns each role's ID, name, description, base role, and capability access levels. Takes no filters or pagination parameters. Requires users:read. An empty list means the business has no custom roles.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Spend Programs
>
> **Slug:** `RAMP_LIST_SPEND_PROGRAMS`
>
> List Ramp spend programs and their spending restrictions, one page at a time. Use page.next's start query parameter to retrieve the next page.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page, used to get the next page.
>
> **page\_size** `integer`
>
> Number of results per page, between 2 and 100. Defaults to 20.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Spend Program Workflow Nodes
>
> **Slug:** `RAMP_LIST_SPEND_PROGRAM_WORKFLOW_NODES`
>
> List 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
>
> **spend\_program\_id** `string` *required*
>
> UUID of the spend program whose workflow nodes to list.
>
> **service\_identifier** `string` *required*
>
> Non-secret external approval integration identifier configured on the program's workflow nodes (Ramp query name: service\_key). This is not an API key or authentication credential.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Statements
>
> **Slug:** `RAMP_LIST_STATEMENTS`
>
> Tool for listing all statements with filtering options. Perfect for financial reporting and reconciliation workflows.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **to\_date** `string`
>
> Filter statements with end\_date on or before this date (ISO 8601 datetime). Defaults to current time
>
> **from\_date** `string`
>
> Filter statements with end\_date on or after this date (ISO 8601 datetime)
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Syncable Banking Transactions
>
> **Slug:** `RAMP_LIST_SYNCABLE_BANKING_TRANSACTIONS`
>
> List 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
>
> **start** `string`
>
> Opaque cursor from the start query parameter in page.next.
>
> **end\_date** `string`
>
> Filter transactions before this date-time (ISO 8601).
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **entity\_ids** `array`
>
> Filter by business entity UUIDs; sent comma-separated.
>
> **start\_date** `string`
>
> Filter transactions after this date-time (ISO 8601).
>
> **include\_synced\_transfers** `boolean`
>
> Include transfers already synced to the accounting provider.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Transfers
>
> **Slug:** `RAMP_LIST_TRANSFERS`
>
> List 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
>
> **start** `string`
>
> Opaque ID from the previous page's page.next start query parameter.
>
> **status** `string ("ACH_CONFIRMED" | "CANCELED" | "COMPLETED" | "ERROR" | "INITIATED" | "NOT_ACKED" | "NOT_ENOUGH_FUNDS" | "PROCESSING_BY_ODFI" | "REJECTED_BY_ODFI" | "RETURNED_BY_RDFI" | "SUBMITTED_TO_FED" | "SUBMITTED_TO_RDFI" | "UNNECESSARY" | "UPLOADED")`
>
> Filter by transfer status.
>
> **to\_date** `string`
>
> Filter transfers that occurred before this ISO8601 datetime.
>
> **entity\_id** `string`
>
> Filter transfers by business entity UUID.
>
> **from\_date** `string`
>
> Filter transfers that occurred after this ISO8601 datetime.
>
> **page\_size** `integer`
>
> Results per page, from 2 to 100 (default 20).
>
> **sync\_status** `string ("NOT_SYNC_READY" | "SYNCED" | "SYNC_READY")`
>
> Filter by sync status. Supersedes has\_no\_sync\_commits if both are provided.
>
> **statement\_id** `string`
>
> Filter transfers included in the specified statement UUID.
>
> **has\_no\_sync\_commits** `boolean`
>
> Filter transfers that have not been synced.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Trips
>
> **Slug:** `RAMP_LIST_TRIPS`
>
> List 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
>
> **start** `string`
>
> ID of the last entity on the previous page; take start from the native page.next URL unchanged.
>
> **status** `string ("cancelled" | "completed" | "ongoing" | "upcoming")`
>
> Filter by trip status.
>
> **to\_date** `string`
>
> ISO 8601 date-time: trips starting on or before this date; with from\_date, overlapping trips are included.
>
> **user\_ids** `array`
>
> Filter by traveler UUIDs; sent as a comma-separated query value.
>
> **from\_date** `string`
>
> ISO 8601 date-time: trips starting on or after this date; with to\_date, overlapping trips are included.
>
> **page\_size** `integer`
>
> Results per page, 2-100 (default 20).
>
> **trip\_name** `string`
>
> Filter by this trip name.
>
> **max\_amount** `string`
>
> Inclusive maximum trip amount, as a decimal string or number.
>
> **min\_amount** `string`
>
> Inclusive minimum trip amount, as a decimal string or number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `RAMP_LIST_USERS`
>
> Tool for listing users in your Ramp organization with flexible filtering. Perfect for user audits, access management, and organizational analysis. Helps identify inactive users, role distribution, and departmental structures.
>
> #### Input Parameters
>
> **role** `string`
>
> Filter by user role
>
> **email** `string`
>
> Filter by email address
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **entity\_id** `string`
>
> Filter by business entity UUID
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **employee\_id** `string`
>
> Filter by user employee\_id
>
> **location\_id** `string`
>
> Filter by location UUID
>
> **department\_id** `string`
>
> Filter by department UUID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vendors
>
> **Slug:** `RAMP_LIST_VENDORS`
>
> Tool 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
>
> **name** `string`
>
> Filter vendors by name
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **is\_active** `boolean`
>
> Filter by vendor active status
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **from\_created\_at** `string`
>
> Show only vendors with created\_at after this date (ISO 8601 datetime)
>
> **sk\_category\_ids** `string`
>
> Show only vendors whose sk\_category\_id matches a Ramp Category Code in the passed list. Expects a comma-separated list of integers
>
> **vendor\_owner\_id** `string`
>
> Unique identifier of the user which owns this vendor (UUID)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vendor Bank Accounts
>
> **Slug:** `RAMP_LIST_VENDORS_ACCOUNTS`
>
> Tool for listing bank accounts associated with a specific vendor. Returns account details including currency, payment method, and default status. Use this to retrieve payment account information for vendor transactions.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **vendor\_id** `string` *required*
>
> The unique identifier (UUID) of the vendor whose bank accounts to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vendor Contacts
>
> **Slug:** `RAMP_LIST_VENDORS_CONTACTS`
>
> Tool for listing contacts associated with a specific vendor. Returns contact information including names, emails, and phone numbers. Use this to find vendor contact details for communication or relationship management.
>
> #### Input Parameters
>
> **start** `string`
>
> ID of the last entity of the previous page for pagination
>
> **page\_size** `integer`
>
> Number of results per page (2-100, default: 20)
>
> **vendor\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor to retrieve contacts for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vendor Credits
>
> **Slug:** `RAMP_LIST_VENDORS_CREDITS`
>
> Tool 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
>
> **start** `string`
>
> The ID of the last entity of the previous page, used for pagination to get the next page
>
> **page\_size** `integer`
>
> The number of results to be returned in each page. The value must be between 2 and 100. If not specified, the default value 20 will be used
>
> **include\_fully\_used** `boolean`
>
> Include vendor credits that are marked as fully used. Defaults to false if not specified
>
> **to\_accounting\_date** `string`
>
> Filter by vendor credits with an accounting date up to or on the provided date (ISO 8601 date format: YYYY-MM-DD)
>
> **from\_accounting\_date** `string`
>
> Filter by vendor credits with an accounting date on or after the provided date (ISO 8601 date format: YYYY-MM-DD)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `RAMP_LIST_WEBHOOKS`
>
> List webhook subscriptions for the organization, including endpoint URLs, event types, and status. The result can be empty when the response does not contain the expected nested subscription list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Accounting Connection Ready to Migrate
>
> **Slug:** `RAMP_MARK_ACCOUNTING_CONNECTION_READY_TO_MIGRATE`
>
> Mark 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
>
> **connection\_id** `string` *required*
>
> UUID of the inactive API-based accounting connection to mark ready to migrate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Accounting Objects Ready to Sync
>
> **Slug:** `RAMP_MARK_ACCOUNTING_OBJECTS_READY_TO_SYNC`
>
> Mark 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
>
> **object\_ids** `array` *required*
>
> UUIDs of 1–500 objects to mark ready to sync. All must belong to the authenticated business; the request fails if any ID is not found.
>
> **object\_type** `string ("REIMBURSEMENT" | "TRANSACTION")` *required*
>
> Type of all objects in object\_ids: Ramp reimbursements or card transactions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Options for Custom Accounting Field
>
> **Slug:** `RAMP_OPTIONS_FOR_CUSTOM_ACCOUNTING_FIELD`
>
> Tool for listing options for a given accounting field.
>
> #### Input Parameters
>
> **field\_id** `string` *required*
>
> UUID of the custom accounting field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Connection
>
> **Slug:** `RAMP_PATCH_ACCOUNTING_CONNECTION`
>
> Tool to update an accounting connection's settings. Use when you need to modify configuration for API-based accounting connections. This endpoint is restricted to Accounting API based connections only.
>
> #### Input Parameters
>
> **settings** `object`
>
> Settings for API-based accounting connections.
>
> **connection\_id** `string` *required*
>
> The UUID of the accounting connection to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Card
>
> **Slug:** `RAMP_PATCH_CARD_RESOURCE`
>
> Tool to update a card's properties including owner, display name, and spending restrictions. Use when you need to modify card settings or reassign card ownership.
>
> #### Input Parameters
>
> **card\_id** `string` *required*
>
> UUID of the card to update
>
> **entity\_id** `string`
>
> Specify ID to update associated business entity (UUID format)
>
> **new\_user\_id** `string`
>
> Specify ID for new card owner (UUID format)
>
> **display\_name** `string`
>
> Cosmetic display name of the card
>
> **spending\_restrictions** `object`
>
> Spending restrictions to update for the card.
>
> **has\_notifications\_enabled** `boolean`
>
> Flag to enable or disable notifications for this card
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Custom Field Option
>
> **Slug:** `RAMP_PATCH_CUSTOM_FIELD_OPTION`
>
> Tool 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
>
> **code** `string`
>
> Code of the custom accounting field option. Only available if not using a direct ERP integration. Provide an empty string to reset the code.
>
> **value** `string`
>
> Name of the custom accounting field option. Only available if not using a direct ERP integration.
>
> **reactivate** `boolean`
>
> Reactivate a deleted custom field option. Only available if not using a direct ERP integration. Must be true if provided.
>
> **visibility** `string ("HIDDEN" | "VISIBLE")`
>
> Visibility status for custom field option.
>
> **display\_name** `string`
>
> Update the display name of the custom field option. Available to all users.
>
> **field\_option\_id** `string` *required*
>
> UUID of the custom accounting field option to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update General Ledger Account
>
> **Slug:** `RAMP_PATCH_GL_ACCOUNT_RESOURCE`
>
> Tool 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
>
> **code** `string`
>
> Code of the general ledger account (e.g., '1500-UPDATED', '6410'). Provide an empty string to reset the code.
>
> **name** `string`
>
> Name of the general ledger account (e.g., 'Updated Equipment Account', 'Travel : Travel - Lodging')
>
> **reactivate** `boolean`
>
> Reactivate a deleted general ledger account. Set to true to reactivate.
>
> **gl\_account\_id** `string` *required*
>
> UUID of the general ledger account to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Inventory Item Field
>
> **Slug:** `RAMP_PATCH_INVENTORY_ITEM_FIELD`
>
> Tool to update the inventory item accounting field for a Ramp connection. Use when you need to modify the name or display name of the inventory item field.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the inventory item field.
>
> **display\_name** `string`
>
> Display name of the inventory item field on Ramp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Accounting GL Accounts
>
> **Slug:** `RAMP_POST_ACCOUNTING_ACCOUNTS`
>
> Tool 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
>
> **gl\_accounts** `array` *required*
>
> A list of general ledger accounts to upload. Maximum 500 accounts per API call. All-or-nothing validation: if any account fails validation, the entire batch is rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post Accounting Codings
>
> **Slug:** `RAMP_POST_ACCOUNTING_CODINGS`
>
> Post 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
>
> **object\_id** `string` *required*
>
> UUID of the Ramp card transaction to code.
>
> **object\_type** `string` *required*
>
> Type of Ramp object to code; only TRANSACTION is supported.
>
> **accounting\_coding\_selections** `array` *required*
>
> Accounting field selections to post to the transaction.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Accounting Connection
>
> **Slug:** `RAMP_POST_ACCOUNTING_CONNECTION`
>
> Tool 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
>
> **settings** `object`
>
> Connection settings for API-based accounting connections. Applies only to API-based connections
>
> **reactivate** `boolean`
>
> Deprecated parameter. Use POST accounting/connection/\<connection\_id>/reactivate instead
>
> **remote\_provider\_name** `string` *required*
>
> The name of the accounting provider to connect to (e.g., QUICKBOOKS, NETSUITE, XERO, ACCOUNTING\_SEED)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post Accounting Syncs
>
> **Slug:** `RAMP_POST_ACCOUNTING_SYNCS`
>
> Report 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
>
> **sync\_type** `string ("ACCRUAL_SYNC" | "BILL_PAYMENT_SYNC" | "BILL_SYNC" | "BROKERAGE_ORDER_SYNC" | "RECOGNITION_SCHEDULE_ENTRY_SYNC" | "REIMBURSEMENT_SYNC" | "REPAYMENT_SYNC" | "STATEMENT_CREDIT_SYNC" | "TRANSACTION_SYNC" | "TRANSFER_SYNC" | "WALLET_TRANSFER_SYNC")` *required*
>
> Type of Ramp objects whose sync results are reported.
>
> **failed\_syncs** `array`
>
> Objects that failed to sync (1–5000). Omit if unused; null is not supported.
>
> **idempotency\_key** `string` *required*
>
> Client-generated unique retry key. Prefer a random UUID; reuse only for retries of the same request.
>
> **sync\_request\_id** `string`
>
> Nullable sync request UUID from the TRANSACTION\_SYNC\_REQUESTED, REIMBURSEMENT\_SYNC\_REQUESTED, or ACCRUAL\_SYNC\_REQUESTED webhook for Sync Button flows. Omit for other flows.
>
> **successful\_syncs** `array`
>
> Successfully synced objects (1–5000). Omit if unused; null is not supported.
>
> **mark\_ready\_to\_sync** `boolean`
>
> Mark successful transactions ready before recording completion, clearing accounting requirements. Only TRANSACTION\_SYNC without sync\_request\_id; failed syncs are unaffected. Defaults to false when omitted; null is not supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Accounting Vendors
>
> **Slug:** `RAMP_POST_ACCOUNTING_VENDORS`
>
> Tool 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
>
> **vendors** `array` *required*
>
> A list of vendors to upload. Maximum 500 vendors per API call. All-or-nothing validation: if any vendor fails validation, the entire batch is rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Inventory Item Options
>
> **Slug:** `RAMP_POST_INVENTORY_ITEM_OPTIONS`
>
> Tool 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
>
> **options** `array` *required*
>
> A list of inventory item options to upload. Maximum 500 items per API call. There must be an active inventory item accounting field for the accounting connection.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Physical Card
>
> **Slug:** `RAMP_POST_PHYSICAL_CARD`
>
> Tool 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
>
> **user\_id** `string` *required*
>
> Unique identifier (UUID) of the card owner. This user will be assigned as the cardholder.
>
> **entity\_id** `string`
>
> Business entity UUID to associate with the card. If not provided, defaults to entity associated with user's location.
>
> **fulfillment** `object`
>
> Fulfillment details for the physical card.
>
> **display\_name** `string` *required*
>
> Cosmetic display name for the card (e.g., 'Business Travel Card', 'T\&E'). Required by the API.
>
> **is\_temporary** `boolean`
>
> Set to true to create a temporary card. Defaults to false.
>
> **card\_program\_id** `string`
>
> Card program ID to use for the card. One of spending\_restrictions or card\_program\_id must be provided.
>
> **idempotency\_key** `string` *required*
>
> Unique value to recognize subsequent retries of the same request. Use a random UUID to avoid collisions.
>
> **spending\_restrictions** `object`
>
> Spending restrictions for the physical card.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reactivate Accounting Connection
>
> **Slug:** `RAMP_REACTIVATE_ACCOUNTING_CONNECTION`
>
> Tool 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
>
> **connection\_id** `string` *required*
>
> The UUID of the accounting connection to reactivate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reactivate User
>
> **Slug:** `RAMP_REACTIVATE_USER`
>
> Tool to reactivate a suspended user in your Ramp organization. Use when you need to restore a user's access. Upon reactivation, users can log in to Ramp again, spend on their previously issued cards, and resume receiving Ramp notifications.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The unique identifier (UUID) of the user to reactivate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Release Bill Hold
>
> **Slug:** `RAMP_RELEASE_BILL_HOLD`
>
> Beta: release a Ramp bill hold so payments can be scheduled again.
>
> #### Input Parameters
>
> **bill\_id** `string` *required*
>
> UUID of the bill whose hold to release.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Release Vendor
>
> **Slug:** `RAMP_RELEASE_VENDOR`
>
> Release 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
>
> **vendor\_id** `string` *required*
>
> Unique identifier of the vendor.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Receipt Integration Opt Out Email
>
> **Slug:** `RAMP_REMOVE_RECEIPT_INTEGRATION_OPT_OUT_EMAIL`
>
> Remove an email from the receipt integration opt-out list by its entry ID. A successful request opts the email back into receipt integrations. Returns an empty object on success. Requires receipt\_integrations:write.
>
> #### Input Parameters
>
> **mailbox\_opted\_out\_email\_uuid** `string` *required*
>
> ID of the receipt integration opt-out entry to remove.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resolve External Approval
>
> **Slug:** `RAMP_RESOLVE_EXTERNAL_APPROVAL`
>
> Approve 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
>
> **action** `string ("approve" | "reject")` *required*
>
> Decision to apply to the external approval workflow step.
>
> **approval\_trigger\_instance\_id** `string` *required*
>
> Blank canvas approval trigger instance ID, not the procurement request or approval instance ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Draft Bill (Beta)
>
> **Slug:** `RAMP_SUBMIT_DRAFT_BILL`
>
> Beta: submit a Ramp draft bill and return the resulting standard bill.
>
> #### Input Parameters
>
> **draft\_bill\_id** `string` *required*
>
> Unique identifier of the draft bill to submit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Procurement Request
>
> **Slug:** `RAMP_SUBMIT_PROCUREMENT_REQUEST`
>
> Submit 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
>
> **unified\_request\_id** `string` *required*
>
> Unified procurement draft request ID (not spend\_request\_id).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Reimbursement Receipt
>
> **Slug:** `RAMP_SUBMIT_REIMBURSEMENT_RECEIPT`
>
> Tool 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
>
> **receipt** `object` *required*
>
> Receipt file to upload. The file name should match the receipt filename (for example, 'receipt.pdf' or 'receipt.jpg').
>
> **reimbursee\_id** `string` *required*
>
> UUID of the user to create the reimbursement for
>
> **idempotency\_key** `string` *required*
>
> Unique value to prevent duplicate uploads. Use a UUID to avoid collisions
>
> **reimbursement\_id** `string`
>
> Optional UUID of existing reimbursement to attach receipt to. If not provided, a new draft reimbursement will be created via OCR
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Suspend Card
>
> **Slug:** `RAMP_SUSPEND_CARD`
>
> Tool 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
>
> **card\_id** `string` *required*
>
> The unique identifier of the card to suspend
>
> **idempotency\_key** `string` *required*
>
> An idempotency key is a unique value generated by the client which the server uses to recognize subsequent retries of the same request. To avoid collisions, we encourage clients to use random generated UUIDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Terminate Card
>
> **Slug:** `RAMP_TERMINATE_CARD`
>
> Tool 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
>
> **card\_id** `string` *required*
>
> The unique identifier of the card to terminate permanently
>
> **idempotency\_key** `string` *required*
>
> An idempotency key is a unique value generated by the client which the server uses to recognize subsequent retries of the same request. To avoid collisions, use random generated UUIDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Custom Accounting Field
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_FIELD`
>
> Tool to update a custom accounting field. Use when you need to modify the display name, name, or splittable setting of an existing custom accounting field.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the custom accounting field.
>
> **field\_id** `string` *required*
>
> UUID of the custom accounting field to update (ramp\_id).
>
> **display\_name** `string`
>
> Update the name of the custom accounting field on Ramp.
>
> **is\_splittable** `boolean`
>
> Update the is\_splittable of the custom accounting field on Ramp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Inventory Item Option
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_INVENTORY_ITEM_OPTIONS`
>
> Update the name of an existing inventory item option in Ramp's accounting system.
>
> #### Input Parameters
>
> **name** `string`
>
> The updated name of the inventory item option
>
> **option\_id** `string` *required*
>
> The Ramp UUID of the inventory item option to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Tax Code
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_TAX_CODE`
>
> Update the tax code accounting field's name and optionally its display name in Ramp's accounting system.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the tax code field.
>
> **display\_name** `string`
>
> Display name of the tax code field on Ramp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Tax Code Option
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_TAX_CODE_OPTIONS`
>
> Tool 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
>
> **name** `string`
>
> The name of the tax code option.
>
> **option\_id** `string` *required*
>
> The unique identifier (UUID) of the tax code option to update
>
> **tax\_rate\_ids** `array`
>
> A list of external tax rate IDs (remote\_id values) to associate with this tax code option. If this value is provided, it will replace all existing tax rate IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Tax Rate
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_TAX_RATE`
>
> Tool to update an accounting tax rate in Ramp. Use when you need to modify the name, rate percentage, or associated GL account for an existing tax rate.
>
> #### Input Parameters
>
> **name** `string`
>
> Name of the tax rate
>
> **rate** `string`
>
> The tax rate percentage expressed as a decimal (e.g. 0.10 for 10%, 0.15 for 15%)
>
> **tax\_rate\_id** `string` *required*
>
> The unique Ramp ID (UUID) of the tax rate to update
>
> **accounting\_gl\_account\_id** `string`
>
> The Ramp ID (UUID) of the GL account to associate with this tax rate
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Accounting Vendor
>
> **Slug:** `RAMP_UPDATE_ACCOUNTING_VENDOR`
>
> Tool 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
>
> **code** `string`
>
> Code of the vendor. Provide an empty string to reset the code.
>
> **name** `string`
>
> Name of the vendor to update
>
> **vendor\_id** `string` *required*
>
> The unique identifier (ramp\_id UUID) of the vendor to update. This is the Ramp-internal UUID, not the external ERP system ID.
>
> **reactivate** `boolean`
>
> Set to true to reactivate a deleted vendor. Only the value true is accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Bill
>
> **Slug:** `RAMP_UPDATE_BILL`
>
> Update an approved Ramp bill. Ramp rejects updates to bills that are not approved.
>
> #### Input Parameters
>
> **memo** `string`
>
> Bill memo. Use clear\_fields to clear it.
>
> **due\_at** `string`
>
> New bill due date.
>
> **bill\_id** `string` *required*
>
> UUID of the approved bill to update.
>
> **entity\_id** `string`
>
> UUID of the business entity associated with the bill.
>
> **issued\_at** `string`
>
> New invoice issue date.
>
> **remote\_id** `string`
>
> Client-side bill ID. Use clear\_fields to clear it.
>
> **vendor\_id** `string`
>
> UUID of the bill vendor.
>
> **line\_items** `array`
>
> Replacement expense line items. Add line\_items to clear\_fields to replace them with an empty list.
>
> **vendor\_memo** `string`
>
> Memo shown to the vendor. Use clear\_fields to clear it.
>
> **clear\_fields** `array`
>
> Fields to clear. Ramp clears line\_items and inventory\_line\_items with an empty list; scalar fields are sent as explicit null. Clear requests override replacement values for the same fields.
>
> **payment\_date** `string`
>
> Scheduled payment initiation date for a non-card payment. Use clear\_fields to unschedule payment.
>
> **posting\_date** `string`
>
> Accounting posting date. Use clear\_fields to clear it.
>
> **invoice\_number** `string`
>
> New invoice number.
>
> **payment\_method** `string ("ACH" | "CARD" | "CHECK" | "CRYPTO_WALLET_TRANSFER" | "DOMESTIC_WIRE" | "INTERNATIONAL" | "LOCAL_BANK_TRANSFER" | "ONE_TIME_CARD" | "ONE_TIME_CARD_DELIVERY" | "PAID_MANUALLY" | "SWIFT")`
>
> New payment method for the bill.
>
> **vendor\_contact\_id** `string`
>
> UUID of a vendor contact associated with the selected vendor.
>
> **purchase\_order\_ids** `array`
>
> Replacement list of matched purchase order UUIDs.
>
> **inventory\_line\_items** `array`
>
> Replacement inventory line items. Add inventory\_line\_items to clear\_fields to replace them with an empty list.
>
> **accounting\_field\_selections** `array`
>
> Accounting field options used to code the bill.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Card Spending Limit
>
> **Slug:** `RAMP_UPDATE_CARD_LIMIT`
>
> Retrieve a card's details, including its current spending restrictions, after querying limits for the card. This tool does not update the spending limit.
>
> #### Input Parameters
>
> **amount** `integer` *required*
>
> New spending limit amount in cents
>
> **card\_id** `string` *required*
>
> The ID of the card to update limits for
>
> **interval** `string` *required*
>
> Spending limit interval: DAILY, WEEKLY, MONTHLY, QUARTERLY, YEARLY, or TOTAL
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Custom Accounting Field Option
>
> **Slug:** `RAMP_UPDATE_CUSTOM_ACCOUNTING_FIELD_OPTION`
>
> Update 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
>
> **code** `string`
>
> Option code; send an empty string to reset. Only available without a direct ERP integration.
>
> **value** `string`
>
> Updated option name. Only available without a direct ERP integration.
>
> **reactivate** `boolean`
>
> Reactivate a deleted option; only true is accepted. Only available without a direct ERP integration.
>
> **visibility** `string ("HIDDEN" | "VISIBLE")`
>
> Hide or show this option, available to all integrations.
>
> **display\_name** `string`
>
> Updated display name, available to all integrations.
>
> **field\_option\_id** `string` *required*
>
> ID of the custom accounting field option to update.
>
> **entity\_remote\_ids** `array`
>
> Remote IDs from POST /developer/v1/accounting/entities. Omit to leave entity scoping unchanged; send null to reset availability to all connected entities.
>
> **accounting\_connection\_id** `string`
>
> Accounting connection UUID. Required for an option on an inactive connection. Verified live on PUT; omitted from the provider PUT OpenAPI parameters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Department
>
> **Slug:** `RAMP_UPDATE_DEPARTMENT`
>
> Tool for updating an existing department in your Ramp organization. Useful for reorganizing departmental structure or renaming departments.
>
> #### Input Parameters
>
> **code** `string`
>
> New department code/identifier
>
> **name** `string`
>
> New name for the department
>
> **department\_id** `string` *required*
>
> ID of the department to update
>
> **parent\_department\_id** `string`
>
> New parent department ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Draft Bill (Beta)
>
> **Slug:** `RAMP_UPDATE_DRAFT_BILL`
>
> Beta: update only explicitly supplied fields on a Ramp draft bill.
>
> #### Input Parameters
>
> **memo** `string`
>
> Internal bill memo. Use the update action's clear\_fields parameter to clear it later.
>
> **due\_at** `string`
>
> Bill due date in YYYY-MM-DD format.
>
> **entity\_id** `string`
>
> UUID of the associated business entity.
>
> **issued\_at** `string`
>
> Invoice issue date in YYYY-MM-DD format.
>
> **remote\_id** `string`
>
> Client-side bill identifier. Use the update action's clear\_fields parameter to clear it later.
>
> **vendor\_id** `string`
>
> UUID of the bill vendor.
>
> **line\_items** `array`
>
> Bill line items. When supplied, replaces all existing line items; use the update action's clear\_fields parameter to clear them later.
>
> **vendor\_memo** `string`
>
> Memo shown to the vendor. Use the update action's clear\_fields parameter to clear it later.
>
> **clear\_fields** `array`
>
> Fields to clear. Each listed field is sent to Ramp as explicit null and overrides a replacement value for the same field.
>
> **posting\_date** `string`
>
> Accounting-system posting date in YYYY-MM-DD format. Use the update action's clear\_fields parameter to clear it later.
>
> **draft\_bill\_id** `string` *required*
>
> Unique identifier of the draft bill to update.
>
> **invoice\_number** `string`
>
> Invoice number on the bill.
>
> **payment\_method** `string ("ACH" | "CARD" | "CHECK" | "CRYPTO_WALLET_TRANSFER" | "DOMESTIC_WIRE" | "INTERNATIONAL" | "LOCAL_BANK_TRANSFER" | "ONE_TIME_CARD" | "ONE_TIME_CARD_DELIVERY" | "PAID_MANUALLY" | "SWIFT")`
>
> Payment method for the bill.
>
> **invoice\_currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDSUI" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")`
>
> ISO 4217 currency code for the invoice.
>
> **vendor\_contact\_id** `string`
>
> UUID of a contact belonging to the selected vendor.
>
> **purchase\_order\_ids** `array`
>
> Purchase order UUIDs to match. Ramp accepts these IDs but does not expose the draft-bill relationship in its read API; successful submission cannot independently confirm that the linkage persisted.
>
> **inventory\_line\_items** `array`
>
> Inventory line items. When supplied, replaces all existing inventory line items; use the update action's clear\_fields parameter to clear them later.
>
> **enable\_accounting\_sync** `boolean`
>
> Set false to prevent the bill from syncing to the ERP.
>
> **use\_default\_payment\_method** `boolean`
>
> Use the vendor's default payment method. Do not also provide payment\_method when true.
>
> **accounting\_field\_selections** `array`
>
> Accounting field options used to code the draft bill.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update External Approval Metadata
>
> **Slug:** `RAMP_UPDATE_EXTERNAL_APPROVAL_METADATA`
>
> Update 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
>
> **url** `string`
>
> URL of the approval request. Omit to exclude from the PATCH; explicit null is sent as JSON null.
>
> **status** `string`
>
> Display name of the approval request status, usually in sentence case. Omit to exclude from the PATCH; explicit null is sent as JSON null.
>
> **recipients** `array`
>
> Recipients of the approval request. Omit to exclude from the PATCH; explicit null and an empty list are sent as supplied.
>
> **approval\_trigger\_instance\_id** `string` *required*
>
> UUID of the external approval trigger instance whose metadata to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Spending Limit
>
> **Slug:** `RAMP_UPDATE_LIMITS`
>
> Update 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
>
> **new\_user\_id** `string`
>
> Change the user of the limit. Must be a valid UUID.
>
> **display\_name** `string`
>
> Change the display name of the limit.
>
> **is\_shareable** `boolean`
>
> Dictates whether the spend limit is shareable among multiple users.
>
> **spend\_limit\_id** `string` *required*
>
> Unique identifier of the spending limit to update.
>
> **accounting\_rules** `array`
>
> Set accounting rules for all card transactions and reimbursements (if applicable) for the given spend limit.
>
> **spend\_program\_id** `string`
>
> Specify a spend program to link with. This will override the limit's spending restrictions and permitted spend types with those of the spend program. Pass None to detach the limit's current spend program. If the spend\_program\_id field is specified, no other fields may be passed.
>
> **permitted\_spend\_types** `object`
>
> Permitted spend types for the limit.
>
> **spending\_restrictions** `object`
>
> Spending restrictions for the limit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Location
>
> **Slug:** `RAMP_UPDATE_LOCATION`
>
> Update 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
>
> **name** `string` *required*
>
> Updated name of the location.
>
> **entity\_id** `string`
>
> Updated UUID of the business entity this location belongs to. Existing users assigned to this location will also move to that entity. Omit to leave unchanged; explicit null is not supported.
>
> **location\_id** `string` *required*
>
> UUID of the location to update; obtain it by listing locations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Procurement Request
>
> **Slug:** `RAMP_UPDATE_PROCUREMENT_REQUEST`
>
> Edit 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
>
> **name** `string`
>
> Replacement name; omit to keep.
>
> **currency** `string ("AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BOV" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHE" | "CHF" | "CHW" | "CLF" | "CLP" | "CNH" | "CNY" | "COP" | "COU" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "EURC" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MXV" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "OPEN_USD" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "USDB" | "USDC" | "USDG" | "USDT" | "USN" | "UYI" | "UYU" | "UYW" | "UZS" | "VED" | "VES" | "VND" | "VUV" | "WST" | "XAD" | "XAF" | "XAG" | "XAU" | "XBA" | "XBB" | "XBC" | "XBD" | "XCD" | "XCG" | "XDR" | "XOF" | "XPD" | "XPF" | "XPT" | "XSU" | "XTS" | "XUA" | "XXX" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL")`
>
> Replacement currency; omit to keep.
>
> **end\_date** `string`
>
> Spend period end, YYYY-MM-DD; omit to keep, null to clear.
>
> **entity\_id** `string`
>
> Replacement business entity ID; omit to keep.
>
> **line\_items** `array`
>
> Complete line replacement: IDs retain/update, absent IDs create, unlisted saved IDs are deleted. Omit to keep all. \[] deletes all lines on drafts only; submitted requests must retain a line. Re-send description to retain it.
>
> **start\_date** `string`
>
> Spend period start, YYYY-MM-DD; omit to keep, null to clear.
>
> **field\_answers** `array`
>
> Complete API-editable answer replacement. Omit to keep; \[] clears all supported answers. Unlisted supported fields are cleared; file uploads are untouched.
>
> **x\_idempotency\_key** `string`
>
> Optional X-Idempotency-Key. Reuse rejects the request rather than replaying the response.
>
> **unified\_request\_id** `string` *required*
>
> Unified request ID, not spend\_request\_id; must be owned by the connected user.
>
> **accounting\_field\_selections** `array`
>
> Complete request-level coding replacement. Omit to keep; unlisted enabled fields are cleared; \[] clears all.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Purchase Order
>
> **Slug:** `RAMP_UPDATE_PURCHASE_ORDER`
>
> Update an approved Ramp Plus purchase order; unapproved orders are rejected by Ramp.
>
> #### Input Parameters
>
> **memo** `string`
>
> Replacement memo. Add memo to clear\_fields to clear it.
>
> **clear\_fields** `array`
>
> Fields to clear. Each listed field is sent to Ramp as explicit null and overrides a replacement value for the same field.
>
> **spend\_end\_date** `string`
>
> Replacement spend end date.
>
> **spend\_start\_date** `string`
>
> Replacement spend start date.
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID to update.
>
> **withholding\_default\_rate** `string`
>
> Replacement retainage rate from 0 (inclusive) to 1 (exclusive); add withholding\_default\_rate to clear\_fields to clear it.
>
> **accounting\_field\_selections** `array`
>
> Replacement body-level accounting coding selections; the list is updated all at once.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Purchase Order Line Item
>
> **Slug:** `RAMP_UPDATE_PURCHASE_ORDER_LINE_ITEM`
>
> Update one line item on an approved Ramp Plus purchase order.
>
> #### Input Parameters
>
> **unit\_price** `string`
>
> Replacement unit price. Ramp accepts a decimal string or JSON number.
>
> **description** `string`
>
> Replacement description. Add description to clear\_fields to clear it.
>
> **clear\_fields** `array`
>
> Fields to clear. Each listed field is sent to Ramp as explicit null and overrides a replacement value for the same field.
>
> **line\_item\_id** `string` *required*
>
> Line item ID to update.
>
> **unit\_quantity** `integer`
>
> Replacement line item quantity.
>
> **withholding\_rate** `string`
>
> Replacement retainage rate from 0 (inclusive) to 1 (exclusive); add withholding\_rate to clear\_fields to clear it.
>
> **purchase\_order\_id** `string` *required*
>
> Purchase order ID.
>
> **accounting\_field\_selections** `array`
>
> Replacement accounting coding selections; the list is updated all at once.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User
>
> **Slug:** `RAMP_UPDATE_USER`
>
> Tool to update an existing user in your Ramp organization. Use when modifying user information such as name, department, role, or manager assignments.
>
> #### Input Parameters
>
> **role** `string ("AUDITOR" | "BUSINESS_ADMIN" | "BUSINESS_BOOKKEEPER" | "BUSINESS_OWNER" | "BUSINESS_USER" | "GUEST_USER" | "IT_ADMIN")`
>
> User role in the Ramp organization.
>
> **user\_id** `string` *required*
>
> Unique identifier of the user to update (UUID format)
>
> **last\_name** `string`
>
> Last name of the user
>
> **first\_name** `string`
>
> First name of the user
>
> **is\_manager** `boolean`
>
> Whether the employee is a manager
>
> **location\_id** `string`
>
> Unique identifier of the employee's location (UUID format)
>
> **auto\_promote** `boolean`
>
> Whether to automatically promote the user's manager to manager role
>
> **department\_id** `string`
>
> Unique identifier of the employee's department (UUID format)
>
> **direct\_manager\_id** `string`
>
> Unique identifier of the employee's direct manager (UUID format). Set to null to remove manager assignment.
>
> **scheduled\_deactivation\_date** `string`
>
> The date when the user is scheduled to be deactivated (YYYY-MM-DD format). Set to null to clear the scheduled deactivation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Vendor
>
> **Slug:** `RAMP_UPDATE_VENDOR`
>
> Update 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
>
> **name** `string`
>
> Vendor name.
>
> **state** `string`
>
> Vendor-level two-letter US state. Required for US vendor country; ignored for non-US countries.
>
> **address** `object`
>
> Vendor address.
>
> **country** `string`
>
> Vendor country.
>
> **is\_active** `boolean`
>
> Whether this vendor is active.
>
> **vendor\_id** `string` *required*
>
> UUID of the vendor to update.
>
> **description** `string`
>
> Vendor description.
>
> **display\_name** `string`
>
> Vendor display name; an empty string clears it.
>
> **default\_entity\_id** `string`
>
> Default entity UUID belonging to this business; null clears it.
>
> **net\_payment\_terms** `integer`
>
> Days until payment due; 0 means due on receipt, null clears, omission leaves unchanged.
>
> **external\_vendor\_id** `string`
>
> Customer-defined ID independent of accounting remote IDs.
>
> **request\_tax\_details** `boolean`
>
> Request tax information. Requires an existing default vendor contact email; defaults to false.
>
> **default\_bank\_account\_id** `string`
>
> Existing bank account UUID belonging to this vendor to use as its default payment method. Does not change existing bills; omit to leave unchanged.
>
> **request\_payment\_details** `boolean`
>
> Request ACH, wire and check payment details. Requires an existing default vendor contact email; defaults to false.
>
> **accounting\_vendor\_remote\_id** `string`
>
> Accounting remote ID; provide at most one of this or vendor\_tracking\_category\_option\_id.
>
> **vendor\_tracking\_category\_option\_id** `string`
>
> Ramp accounting vendor UUID; provide at most one of this or accounting\_vendor\_remote\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Vendor Bank Accounts
>
> **Slug:** `RAMP_UPDATE_VENDOR_BANK_ACCOUNTS`
>
> Add 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
>
> **vendor\_id** `string` *required*
>
> Unique identifier (UUID) of the vendor.
>
> **is\_default** `boolean`
>
> Whether this is the default payment method.
>
> **ach\_details** `object`
>
> US ACH payment details.
>
> **wire\_details** `object`
>
> US wire payment details.
>
> **crypto\_details** `object`
>
> Crypto wallet (stablecoin) payout details.
>
> **account\_nickname** `string`
>
> Optional payment account nickname.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Bill Attachment
>
> **Slug:** `RAMP_UPLOAD_BILL_ATTACHMENT`
>
> Upload an invoice or supporting file to an existing Ramp bill.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to attach to the bill
>
> **bill\_id** `string` *required*
>
> Unique identifier of the bill
>
> **attachment\_type** `string ("INVOICE" | "FILE")` *required*
>
> Attachment type. Use INVOICE for the bill's invoice or FILE for another supporting file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Draft Bill Attachment
>
> **Slug:** `RAMP_UPLOAD_DRAFT_BILL_ATTACHMENT`
>
> Upload an invoice or supporting file to an existing Ramp draft bill.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to attach to the draft bill
>
> **draft\_bill\_id** `string` *required*
>
> Unique identifier of the draft bill
>
> **attachment\_type** `string ("INVOICE" | "FILE")` *required*
>
> Attachment type. Use INVOICE for the bill's invoice or FILE for another supporting file
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload External Approval Document
>
> **Slug:** `RAMP_UPLOAD_EXTERNAL_APPROVAL_DOCUMENT`
>
> Upload 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
>
> **document** `object` *required*
>
> Document to upload for the blank canvas workflow step.
>
> **unified\_request\_id** `string` *required*
>
> Unique identifier of the unified request to upload the document to. Must be associated with a spend request.
>
> **vendor\_document\_category** `string ("ADDENDUM_OR_RIDER" | "AMENDMENT" | "BANK_LETTER" | "CAIQ_LITE" | "CERTIFICATE_OF_INSURANCE" | "CONTRACT_OTHER" | "DATA_PROTECTION_AGREEMENT" | "ECOVADIS" | "ENGAGEMENT_LETTER" | "FAQ" | "FORM_1099" | "GDPR" | "HIPAA" | "INVOICE" | "ISO_27001" | "ISO_9001" | "MSA" | "NDA" | "NMSDC_CERTIFICATION" | "ORDER_FORM" | "OTHER" | "PAYMENT_INSTRUCTIONS" | "PCI_DSS" | "PEN_TEST_REPORT" | "PRIVACY_POLICY" | "PURCHASE_ORDER" | "QUESTIONNAIRE" | "QUOTE" | "SECURITY_DOCUMENT" | "SECURITY_EXHIBIT" | "SIG" | "SLA" | "SOC_1_TYPE_1" | "SOC_1_TYPE_2" | "SOC_2" | "SOW" | "TAX_DOCUMENT" | "TAX_DOCUMENT_INTL_COR" | "TAX_DOCUMENT_INTL_GOV_FORM" | "TAX_DOCUMENT_INTL_OTHER" | "TAX_DOCUMENT_INTL_STATUTORY_FORM" | "TOS" | "VENDOR_CONTRACT" | "VENDOR_CREDIT" | "VOIDED_CHECK" | "W8" | "W9")` *required*
>
> Category of document to upload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload New Options for Custom Accounting Field
>
> **Slug:** `RAMP_UPLOAD_NEW_OPTIONS`
>
> Tool for uploading new options for a given accounting field.
>
> #### Input Parameters
>
> **options** `array` *required*
>
> A list of field options for a given custom accounting field.
>
> **field\_id** `string` *required*
>
> UUID of the custom accounting field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Procurement Request Attachment
>
> **Slug:** `RAMP_UPLOAD_PROCUREMENT_REQUEST_ATTACHMENT`
>
> Upload 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
>
> **file** `object` *required*
>
> File to attach to the request.
>
> **attachment\_type** `string ("SPEND_REQUEST" | "PURCHASE_ORDER")`
>
> SPEND\_REQUEST (default) is a supporting document not shared with the vendor. PURCHASE\_ORDER appends the file to the purchase order PDF sent to the vendor.
>
> **idempotency\_key** `string` *required*
>
> Client-generated X-Idempotency-Key header. Reuse the same key when retrying the same upload; 1–255 characters.
>
> **unified\_request\_id** `string` *required*
>
> Unique identifier of the procurement request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Receipt
>
> **Slug:** `RAMP_UPLOAD_RECEIPT`
>
> Upload 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
>
> **receipt** `object` *required*
>
> Receipt image or PDF to upload.
>
> **user\_id** `string` *required*
>
> User to associate with the receipt; affects transaction matching priority.
>
> **transaction\_id** `string`
>
> Transaction to attach to the receipt. If omitted, Ramp attempts to match a transaction automatically.
>
> **idempotency\_key** `string` *required*
>
> Caller-supplied form field that makes upload retries idempotent. Reuse the same key for the same upload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Tax Code Options
>
> **Slug:** `RAMP_UPLOAD_TAX_CODE_OPTIONS`
>
> Tool 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
>
> **options** `array` *required*
>
> A list of tax code options to upload. Must contain at least 1 option and at most 500 options per API call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Accounting Tax Rates
>
> **Slug:** `RAMP_UPLOAD_TAX_RATES`
>
> Tool 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
>
> **tax\_rates** `array` *required*
>
> A list of tax rates to upload. Maximum 500 tax rates per API call. All-or-nothing validation: if any tax rate fails validation or violates a database constraint, the entire batch is rejected. Ensure tax rates do not already exist on Ramp before uploading.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Webhook
>
> **Slug:** `RAMP_VERIFY_WEBHOOK`
>
> Verify 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.
>
> #### Input Parameters
>
> **challenge** `string` *required*
>
> Challenge received in Ramp's webhooks.verification POST to your webhook endpoint. Return 2xx to that delivery, then submit its challenge here unchanged.
>
> **webhook\_id** `string` *required*
>
> UUID of the webhook subscription to verify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
