Add Purchase Order Line Items
Add line items to an existing Ramp Plus purchase order.
ActionTry it
Integrate Ramp
with your AI CRM
Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business
Explore Triggers and Actions
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.
ActionTry it
Archive Bill
Archive a bill, cancelling inflight payments or terminating its one-time card where possible. Paid and batch-payment bills cannot be archived.
ActionTry it
Archive Purchase Order
Archive a Ramp Plus purchase order. This destructive operation is irreversible.
ActionTry it
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.
ActionTry it
Create 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.
ActionTry it
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.
ActionTry it
Create Bill
Create a Ramp bill. Ramp does not support creating batch payments through this API.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Create Department
Tool for creating a new department in your Ramp organization. Perfect for setting up organizational structure and expense categorization.
ActionTry it
Create Draft Bill (Beta)
Beta: create a Ramp draft bill for a vendor without submitting it.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Create 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.
ActionTry it
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.
ActionTry it
Create Purchase Order
Create a purchase order. Purchase Orders require a Ramp Plus account.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Create Transaction Memo
Tool for uploading a new memo for a transaction in Ramp. Use when you need to add notes or context to existing transactions.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Delete Accounting GL Account
Tool to delete a general ledger account from Ramp. Use when you need to remove a GL account from the accounting system.
ActionTry it
Delete Accounting Inventory Item Option
Tool to delete an accounting inventory item option from Ramp. Use when you need to remove an inventory item option from the accounting system.
ActionTry it
Delete Accounting Tax Code Option
Tool to delete a tax code option from Ramp. Use when you need to remove a tax code option from the accounting system.
ActionTry it
Delete Accounting Tax Rate
Tool to delete an accounting tax rate from Ramp. Use when you need to remove a tax rate from the accounting system.
ActionTry it
Delete Accounting Vendor
Tool to delete an accounting vendor from Ramp. Use when you need to remove a vendor from the accounting system.
ActionTry it
Delete Custom Accounting Field
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Delete Item Receipt
Delete an item receipt by its ID. Requires Ramp Plus. Returns an empty object after successful deletion (HTTP 204).
ActionTry it
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.
ActionTry it
Delete Purchase Order Line Item
Delete one line item from an approved Ramp Plus purchase order.
ActionTry it
Delete Tax Code Accounting Field
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.
ActionTry it
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.
ActionTry it
Delete Webhook Subscription
Delete a Ramp webhook subscription by ID. The operation is irreversible and returns a success indicator when the request succeeds.
ActionTry it
Download Bill Remittance Receipt
Download the remittance receipt PDF for a Ramp bill.
ActionTry it
Fetch 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.
ActionTry it
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.
ActionTry it
Fetch All Accounting 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.
ActionTry it
Fetch Custom Accounting Field
Tool for fetching a custom accounting field.
ActionTry it
Fetch General Ledger 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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get All Transactions
List a page of Ramp transactions, with optional filters and sorting. Pagination information can be used to request subsequent pages.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get Bill
Fetch one Ramp bill by ID, including its coding, line items, and payment.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get Department
Retrieve a specific Ramp department by ID, returning its ID and name.
ActionTry it
Get Draft Bill (Beta)
Beta: retrieve one Ramp draft bill by its unique identifier.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get Item Receipt
Fetch an item receipt by UUID, including its purchase order, line items and document URLs. Requires Ramp Plus.
ActionTry it
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.
ActionTry it
Get Memo
Tool to fetch a transaction memo. Use when you need to retrieve the memo text associated with a specific transaction.
ActionTry it
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.
ActionTry it
Get Purchase Order
Fetch a Ramp Plus purchase order and its detailed line items.
ActionTry it
Get Receipt
Fetch a Ramp receipt by UUID, returning a temporary image URL and optional structured OCR data.
ActionTry it
Get Reimbursement Details
Retrieve details of a specific reimbursement, including amount, status, user information, accounting details, and receipts, for approval workflows or analysis.
ActionTry it
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.
ActionTry it
Get Spend Program
Retrieve one Ramp spend program by ID, including restrictions and request forms.
ActionTry it
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.
ActionTry it
Get Transaction Details
Tool for retrieving complete details of a specific transaction. Includes merchant details, receipts, accounting codes, and dispute information.
ActionTry it
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.
ActionTry it
Get Trip
Fetch an existing Ramp trip by UUID, including locations, spend events and totals.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get Vendor Details
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.
ActionTry it
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.
ActionTry it
Hold Bill
Beta: place a Ramp bill on hold, blocking all payment rails and descheduling payments.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List 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.
ActionTry it
List All 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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Bills
List Ramp bills using payment, status, accounting, date, and amount filters.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Custom 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.
ActionTry it
List Departments
List Ramp departments with pagination, returning department IDs and names.
ActionTry it
List Draft Bills (Beta)
Beta: list Ramp draft bills with filters and cursor pagination.
ActionTry it
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.
ActionTry it
List General Ledger Accounts
Tool to list general ledger accounts from Ramp. Use when you need to retrieve GL accounts for accounting integration or transaction categorization.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Purchase Orders
List and filter Ramp Plus purchase orders using cursor pagination.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Reimbursements
List reimbursements with filtering options. Returns reimbursement details including amounts, status, and associated entities for expense analysis and approval workflows.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Statements
Tool for listing all statements with filtering options. Perfect for financial reporting and reconciliation workflows.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
List Vendor Bank 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.
ActionTry it
List Vendor 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.
ActionTry it
List Vendor 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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Options for Custom Accounting Field
Tool for listing options for a given accounting field.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Release Bill Hold
Beta: release a Ramp bill hold so payments can be scheduled again.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Remove Users from Shared Limit
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.
ActionTry it
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.
ActionTry it
Submit Draft Bill (Beta)
Beta: submit a Ramp draft bill and return the resulting standard bill.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Update 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.
ActionTry it
Update Accounting Inventory Item Option
Update the name of an existing inventory item option in Ramp's accounting system.
ActionTry it
Update Accounting Tax Code
Update the tax code accounting field's name and optionally its display name in Ramp's accounting system.
ActionTry it
Update Accounting Tax Code Option
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Update Bill
Update an approved Ramp bill. Ramp rejects updates to bills that are not approved.
ActionTry it
Update Card
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.
ActionTry it
Update Card Spending 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.
ActionTry it
Update Custom 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.
ActionTry it
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.
ActionTry it
Update 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.
ActionTry it
Update Department
Tool for updating an existing department in your Ramp organization. Useful for reorganizing departmental structure or renaming departments.
ActionTry it
Update Draft Bill (Beta)
Beta: update only explicitly supplied fields on a Ramp draft bill.
ActionTry it
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.
ActionTry it
Update General Ledger Account
Tool to update a general ledger account in Ramp. Use when you need to modify the name, code, or reactivate a deleted GL account.
ActionTry it
Update 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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Update Purchase Order
Update an approved Ramp Plus purchase order; unapproved orders are rejected by Ramp.
ActionTry it
Update Purchase Order Line Item
Update one line item on an approved Ramp Plus purchase order.
ActionTry it
Update Spending Limit
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Upload Accounting GL 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.
ActionTry it
Upload Accounting 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.
ActionTry it
Upload 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.
ActionTry it
Upload Bill Attachment
Upload an invoice or supporting file to an existing Ramp bill.
ActionTry it
Upload Draft Bill Attachment
Upload an invoice or supporting file to an existing Ramp draft bill.
ActionTry it
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).
ActionTry it
Upload 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.
ActionTry it
Upload New Options for Custom Accounting Field
Tool for uploading new options for a given accounting field.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
How the Ramp integration works
The Ramp integration connects your Dench AI CRM directly to Ramp, so agents can read and act on your Ramp data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
186 actions are available for agents to invoke on your behalf. Every call runs through Ramp's own authorization, scoped to the account you connect.
Set up Ramp in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Ramp and click Connect — you'll authorize access through Ramp's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Ramp in chat, or call it from an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Ramp integration work with Dench?
The Dench Ramp integration connects your AI CRM to Ramp, so AI agents can work with your Ramp data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Ramp via Dench?
The Ramp integration currently exposes 186 actions, including Add Purchase Order Line Items, Add Receipt Integration Opt Out Email, Archive Bill, Archive Purchase Order, Archive Vendor Bank Account, and Create Accounting Connection. Agents invoke them on your behalf from chat or from automations.
Do I need to write code to connect Ramp to Dench?
No. You connect Ramp from your Dench workspace using Ramp's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Ramp integration secure?
Connections are authorized through Ramp's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Ramp connection from your workspace settings at any time.