Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business
Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business On Nagent, Ramp is exposed as a fully-configurable accounting integration that any agent can call — 88 actions, and OAuth authentication. No code is required to wire Ramp into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Ramp to automate the kinds of tasks accounting teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Ramp into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Ramp, with input parameters and output schema. Drop these into any step of an agent built in Helix.
RAMP_CREATE_DEPARTMENTTool for creating a new department in your Ramp organization. Perfect for setting up organizational structure and expense categorization.
Input parameters
Name of the department
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_INVENTORY_ITEM_ACCOUNTING_FIELDTool to create a new inventory item accounting field for tracking inventory categories. Use when setting up inventory tracking for an accounting connection. Note: There can only be one active inventory item accounting field per accounting connection.
Input parameters
Name of the inventory item tracking category in the remote ERP system
The name of the inventory item tracking category as shown on Ramp. If not provided, defaults to the name field
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_MEMOTool for uploading a new memo for a transaction in Ramp. Use when you need to add notes or context to existing transactions.
Input parameters
Text content of the memo to create. Maximum length is 255 characters.
Unique identifier for the transaction to attach the memo to
Whether this memo should automatically apply to similar future transactions. Defaults to false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_MILEAGE_REIMBURSEMENTTool to create a mileage reimbursement in Ramp. Use when a user needs to submit a reimbursement for business-related travel distance. Requires distance, reimbursee_id, and trip_date as mandatory fields.
Input parameters
Memo or note describing the purpose of the mileage reimbursement. This field is required.
Distance traveled for the reimbursement. Can be specified as a number or string.
Date of the trip in ISO 8601 date format (YYYY-MM-DD).
List of intermediate stops during the trip.
Ending location of the trip.
Unique identifier (UUID) of the user to be reimbursed.
Distance units for mileage reimbursement.
Starting location of the trip.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_NEW_CUSTOM_ACCOUNTING_FIELDTool for creating a new custom accounting field. Note: This operation requires elevated permissions not available in the demo API.
Input parameters
Remote/external ID of custom accounting field from ERP system.
Name of the custom accounting field.
The input type could be SINGLE_CHOICE, BOOLEAN or FREE_FORM_TEXT.
If set to True, the accounting field can be used to annotate split line items.
Types of objects that require this accounting field to be used for coding before they can be marked as ready to sync.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_TAX_CODE_ACCOUNTING_FIELDTool to create a new tax code accounting field in Ramp. There can only be one active tax code accounting field per accounting connection. Use when you need to set up tax code tracking for an accounting integration.
Input parameters
Name of the tax code field in the remote ERP system.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_USER_INVITETool to create a user invite for onboarding new employees to Ramp. Triggers an async task to send an invite email. Users must accept the invite to be onboarded. Assign users to specific entities using location_id.
Input parameters
The employee's role in the organization. Note that BUSINESS_OWNER is not an invitable role
The employee's email address where the invite will be sent
Last name of the employee (max 255 characters)
First name of the employee (max 255 characters)
Whether the employee is a manager
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)
Unique identifier of the employee's department (UUID format)
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
Unique identifier of the employee's direct manager (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_CREATE_WEBHOOK_SUBSCRIPTIONTool to create a new webhook subscription for receiving event notifications from Ramp. Use when you need to set up real-time notifications for events like transactions, bills, or reimbursements. The newly registered subscription will be in pending verification state and requires endpoint verification with the provided challenge.
Input parameters
List of event types to subscribe to. The webhook will receive notifications for these events
URL where webhook events will be sent. Must be a valid HTTPS URL that can receive POST requests
Optional headers to include with webhook requests. Max 5 headers allowed. Header names max 100 chars, values max 1000 chars
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DEACTIVATE_USERTool 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
The unique identifier (UUID) of the user to deactivate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_ACCOUNTTool to delete a general ledger account from Ramp. Use when you need to remove a GL account from the accounting system.
Input parameters
The unique identifier (UUID) of the general ledger account to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_CONNECTIONTool to disconnect the current active API-based accounting connection. Use when you need to disable the accounting integration. This action will clear associated accounting settings including Custom Fields, GL Accounts, and Vendors. Only API-based connections can be disconnected via this endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_FIELDSTool 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
The unique identifier (UUID) of the custom accounting field to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_INVENTORY_ITEM_OPTIONSTool 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
The unique identifier (UUID) of the inventory item option to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_TAX_CODETool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_TAX_CODE_OPTIONSTool to delete a tax code option from Ramp. Use when you need to remove a tax code option from the accounting system.
Input parameters
The unique identifier (UUID) of the tax code option to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_TAX_RATESTool to delete an accounting tax rate from Ramp. Use when you need to remove a tax rate from the accounting system.
Input parameters
The unique identifier (UUID) of the tax rate to delete
The accounting connection ID (UUID) associated with the tax rate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_ACCOUNTING_VENDORSTool to delete an accounting vendor from Ramp. Use when you need to remove a vendor from the accounting system.
Input parameters
The unique identifier (UUID) of the vendor to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_CUSTOM_FIELD_OPTIONTool 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
The unique identifier (UUID) of the custom accounting field option to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_INVENTORY_ITEM_FIELDTool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_SPEND_ALLOCATION_DELETE_USERSTool 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
List of user IDs (UUIDs) to remove from the shared limit
Unique identifier (UUID) of the shared spend limit to remove users from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_DELETE_WEBHOOKTool to delete a webhook subscription by ID. Use when you need to remove a webhook subscription from Ramp. The operation is irreversible and returns no content on success.
Input parameters
The unique identifier (UUID) of the webhook subscription to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_FETCH_ACCOUNTING_ACCOUNTTool to fetch a specific general ledger account by ID from Ramp. Use when you need to retrieve detailed information about a single GL account.
Input parameters
UUID of the general ledger account to retrieve
UUID of the accounting connection to filter the GL account. Required when fetching accounts associated with a specific accounting connection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_FETCH_ACCOUNTING_VENDORTool to fetch a specific accounting vendor by ID from Ramp. Use when you need to retrieve detailed information about a single accounting vendor for coding transactions, reimbursements, bills, or purchase orders.
Input parameters
UUID of the accounting vendor to retrieve
UUID of the accounting connection to filter the vendor. Used when fetching vendors associated with a specific accounting connection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_FETCH_CUSTOM_ACCOUNTING_FIELDTool for fetching a custom accounting field.
Input parameters
UUID of the custom accounting field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_ACCOUNTSTool to list general ledger accounts from Ramp. Use when you need to retrieve GL accounts for accounting integration or transaction categorization.
Input parameters
Filter by account code (e.g., '6410')
The ID of the last entity of the previous page, used for pagination to get the next page
Filter by active status. If not provided, returns all accounts. If true, returns only active accounts. If false, returns only inactive accounts.
Filter by sync status with the accounting system
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.
Filter by Remote/external ID from the ERP system
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_ALL_CONNECTIONSTool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_CONNECTIONTool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_CONNECTION_BY_IDTool 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
UUID of the accounting connection to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_FIELDSTool to list custom accounting fields for coding transactions. Use when you need to retrieve custom accounting fields that can be leveraged to code transactions, reimbursements, and bills.
Input parameters
The ID of the last entity of the previous page, used for pagination to get the next page
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ACCOUNTING_VENDORSTool to list accounting vendors from Ramp. Use when you need to retrieve vendor data for transaction coding, reimbursements, bills, or purchase orders in the accounting system.
Input parameters
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.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_ALL_TRANSACTIONSGet all the transactions.
Input parameters
ID of the last entity of the previous page for pagination
Filter by transaction state. If set to 'ALL', all transactions including 'DECLINED' will be listed
Filter by physical card UUID
Filter for transactions with user_transaction_time before the given date (ISO 8601 datetime, default: today)
Filter for trip UUID
Filter by user UUID
Filter by limit UUID
Filter transactions by business entity UUID
Filter for transactions with user_transaction_time after the given date (ISO 8601 datetime)
Number of results per page (2-100, default: 20)
Filter for transactions with amount smaller than given amount (USD)
Filter for transactions with amount larger than given amount (USD)
Filter for transactions that are coded with accounting fields and ready to sync to ERP systems
Filter by location UUID
Filter by merchant UUID
Filter for transactions by sync status. Supersedes sync_ready and has_no_sync_commits if set
Filter by statement UUID
Filter for transactions synced after the given date (ISO 8601 datetime)
Filter by department UUID
Filters for transactions which require a memo but do not have one (can only be set to true)
Filter by Ramp category code (integer)
Filter by transaction approval status
Filter by spend program UUID
Sort transactions by user_transaction_date in ascending order
Sort transactions by user_transaction_date in descending order
Filter for transactions that have not been synced to ERP systems yet
Sort transactions by amount in ascending order
Sort transactions by amount in descending order
Include all purchase data provided by the merchant
Filter for transactions awaiting approval by a specific user UUID
Filter transactions by accounting field selection UUID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_CARDTool 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
The ID of the card to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_CARD_VAULT_RESOURCETool 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
The unique identifier of the card to fetch sensitive details for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_CUSTOM_FIELD_OPTIONTool 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
UUID of the custom accounting field option to fetch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_DEPARTMENTTool for retrieving detailed information about a specific department. Returns comprehensive department details including hierarchy information. Use this to get complete department profile for organizational analysis.
Input parameters
The ID of the department to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_INVENTORY_ITEM_FIELDTool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_MEMOTool to fetch a transaction memo. Use when you need to retrieve the memo text associated with a specific transaction.
Input parameters
Unique identifier of the transaction for which to retrieve the memo (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_REIMBURSEMENTTool for retrieving complete details of a specific reimbursement. Includes amount, status, user information, accounting details, receipts, and sync status. Use this to get comprehensive reimbursement information for approval workflows or detailed analysis.
Input parameters
ID of the reimbursement to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_SPEND_LIMITTool 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
The unique identifier (UUID) of the spend limit to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_STATEMENTTool for retrieving statement details or downloading statements. Supports JSON, PDF, and CSV formats for financial reporting.
Input parameters
Format of the statement: json, pdf, csv
ID of the statement to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_TRANSACTIONTool for retrieving complete details of a specific transaction. Includes merchant details, receipts, accounting codes, and dispute information.
Input parameters
ID of the transaction to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_USERTool 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
The unique identifier (UUID) of the user to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_USERS_DEFERRED_STATUSTool 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
Unique identifier of the deferred task to retrieve status for (UUID format)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_VENDORTool 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
The ID of the vendor to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_GET_WEBHOOKTool 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
The unique identifier of the webhook subscription to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_ISSUE_VIRTUAL_CARDTool for issuing virtual cards to users instantly. Creates cards with customizable spending limits and restrictions. Returns full card details including card number and CVV.
Input parameters
Memo for the card creation
User ID to issue the card to
Display name for the card
Card program ID to use for the card
Spending restrictions for the card
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_ACCOUNTING_INVENTORY_ITEM_OPTIONSTool to list accounting inventory item options from Ramp. Use when you need to retrieve inventory items for accounting integration or transaction categorization.
Input parameters
Filter by code
The ID of the last entity of the previous page, used for pagination to get the next page
Filter by active status. If not provided, returns all objects. If true, returns only active objects. If false, returns only inactive objects.
Filter by sync status with the accounting system
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.
Filter by Remote/external ID from the ERP system
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_ACCOUNTING_TAX_RATESTool to list tax rates from Ramp's accounting integration. Use when you need to retrieve tax rate information for transaction categorization or tax compliance.
Input parameters
The ID of the last entity of the previous page, used for pagination to get the next page
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_CARDSTool 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
ID of the last entity of the previous page for pagination
Filter by card owner UUID
Filter by business entity UUID
Number of results per page (2-100, default: 20)
Filter by display name
Filter only for activated cards. Defaults to True if not specified
Filter only for terminated cards. Defaults to False if not specified
Filter by card program UUID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_DEPARTMENTSTool for listing all departments in the organization. Returns department details including names, codes, and hierarchy information. Use this to analyze organizational structure and department relationships.
Input parameters
ID of the last entity of the previous page for pagination
Number of results per page (2-100, default: 20)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_MEMOSTool 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
ID of the last entity of the previous page for pagination
Filter memos by card UUID
Filter memos for transactions before this date (ISO 8601 format)
Filter memos by user UUID
Filter memos for transactions after this date (ISO 8601 format)
Number of results per page (2-100, default: 20)
Filter memos by manager UUID
Filter memos by location UUID
Filter memos by merchant UUID
Filter memos by department UUID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_REIMBURSEMENTSTool for listing reimbursements with comprehensive filtering options. Returns reimbursement details including amounts, status, sync information, and associated entities. Use this to analyze reimbursement patterns, track approval workflows, and manage expense reimbursements.
Input parameters
ID of the last entity of the previous page for pagination
Filter reimbursements created before this date (ISO 8601 datetime)
Filter reimbursements associated with a specific trip UUID
Filter by user UUID
Filter by direction (BUSINESS_TO_USER default, USER_TO_BUSINESS for repayments)
Filter reimbursements by business entity UUID
Filter reimbursements created after this date (ISO 8601 datetime)
Number of results per page (2-100, default: 20)
Filter reimbursements that are ready to sync to ERP systems
Filter by sync status. Supersedes has_no_sync_commits and sync_ready
Filter reimbursements synced after this date (ISO 8601 datetime)
Filter reimbursements updated after this date (ISO 8601 datetime)
Filter reimbursements submitted before this date (ISO 8601 datetime)
Filter reimbursements submitted after this date (ISO 8601 datetime)
Filter reimbursements that haven't been synced to ERP systems
Filter by underlying transaction date (before this date, ISO 8601 datetime)
Filter by underlying transaction date (after this date, ISO 8601 datetime)
Filter for reimbursements awaiting approval by a specific user UUID
Filter reimbursements by accounting field selection UUID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_STATEMENTSTool for listing all statements with filtering options. Perfect for financial reporting and reconciliation workflows.
Input parameters
ID of the last entity of the previous page for pagination
Filter statements with end_date on or before this date (ISO 8601 datetime). Defaults to current time
Filter statements with end_date on or after this date (ISO 8601 datetime)
Number of results per page (2-100, default: 20)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_USERSTool 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
Filter by user role
Filter by email address
ID of the last entity of the previous page for pagination
Filter by business entity UUID
Number of results per page (2-100, default: 20)
Filter by user employee_id
Filter by location UUID
Filter by department UUID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_VENDORSTool for listing vendors with their spending information. Returns vendor details including spending totals, categories, and activity status. Use this to analyze vendor relationships and procurement patterns.
Input parameters
Filter vendors by name
ID of the last entity of the previous page for pagination
Filter by vendor active status
Number of results per page (2-100, default: 20)
Show only vendors with created_at after this date (ISO 8601 datetime)
Show only vendors whose sk_category_id matches a Ramp Category Code in the passed list. Expects a comma-separated list of integers
Unique identifier of the user which owns this vendor (UUID)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_VENDORS_ACCOUNTSTool 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
ID of the last entity of the previous page for pagination
Number of results per page (2-100, default: 20)
The unique identifier (UUID) of the vendor whose bank accounts to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_VENDORS_CONTACTSTool 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
ID of the last entity of the previous page for pagination
Number of results per page (2-100, default: 20)
Unique identifier (UUID) of the vendor to retrieve contacts for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_VENDORS_CREDITSTool to list all vendor credits for all vendors of a business. Use when you need to track vendor credits, analyze credit usage across vendors, or reconcile vendor accounts.
Input parameters
The ID of the last entity of the previous page, used for pagination to get the next page
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 vendor credits that are marked as fully used. Defaults to false if not specified
Filter by vendor credits with an accounting date up to or on the provided date (ISO 8601 date format: YYYY-MM-DD)
Filter by vendor credits with an accounting date on or after the provided date (ISO 8601 date format: YYYY-MM-DD)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_LIST_WEBHOOKSTool for listing all webhook subscriptions for the organization. Returns webhook details including endpoint URLs, event types, and status. Use this to audit webhook configurations and monitor active subscriptions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_OPTIONS_FOR_CUSTOM_ACCOUNTING_FIELDTool for listing options for a given accounting field.
Input parameters
UUID of the custom accounting field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_PATCH_ACCOUNTING_CONNECTIONTool 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 for API-based accounting connections.
The UUID of the accounting connection to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_PATCH_CARD_RESOURCETool 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
UUID of the card to update
Specify ID to update associated business entity (UUID format)
Specify ID for new card owner (UUID format)
Cosmetic display name of the card
Spending restrictions to update for the card.
Flag to enable or disable notifications for this card
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_PATCH_CUSTOM_FIELD_OPTIONTool to update a custom accounting field option. Use when you need to modify display name, code, value, or visibility of an existing field option.
Input parameters
Code of the custom accounting field option. Only available if not using a direct ERP integration. Provide an empty string to reset the code.
Name of the custom accounting field option. Only available if not using a direct ERP integration.
Reactivate a deleted custom field option. Only available if not using a direct ERP integration. Must be true if provided.
Visibility status for custom field option.
Update the display name of the custom field option. Available to all users.
UUID of the custom accounting field option to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_PATCH_GL_ACCOUNT_RESOURCETool to update a general ledger account in Ramp. Use when you need to modify the name, code, or reactivate a deleted GL account.
Input parameters
Code of the general ledger account (e.g., '1500-UPDATED', '6410'). Provide an empty string to reset the code.
Name of the general ledger account (e.g., 'Updated Equipment Account', 'Travel : Travel - Lodging')
Reactivate a deleted general ledger account. Set to true to reactivate.
UUID of the general ledger account to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_PATCH_INVENTORY_ITEM_FIELDTool 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 of the inventory item field.
Display name of the inventory item field on Ramp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_POST_ACCOUNTING_ACCOUNTSTool to batch upload general ledger accounts to Ramp. Supports up to 500 accounts per call with all-or-nothing validation. Use when you need to create GL accounts in Ramp's accounting system.
Input parameters
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_POST_ACCOUNTING_CONNECTIONTool to register a new API-based accounting connection between Ramp and an accounting provider. Use when establishing a new connection to accounting systems like QuickBooks, NetSuite, or Xero. If a Universal CSV connection exists, it will be upgraded to an API-based connection.
Input parameters
Connection settings for API-based accounting connections. Applies only to API-based connections
Deprecated parameter. Use POST accounting/connection/<connection_id>/reactivate instead
The name of the accounting provider to connect to (e.g., QUICKBOOKS, NETSUITE, XERO, ACCOUNTING_SEED)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_POST_ACCOUNTING_VENDORSTool to batch upload vendors to Ramp for coding transactions, bills, and purchase orders. Supports up to 500 vendors per call with all-or-nothing validation. Use when you need to create vendors in Ramp's accounting system.
Input parameters
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_POST_INVENTORY_ITEM_OPTIONSTool to upload inventory item options for an active inventory item accounting field. Use when you need to create inventory items in Ramp's accounting system.
Input parameters
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_POST_PHYSICAL_CARDTool to create a physical card asynchronously. Returns a task ID which can be used to track the card creation status. Physical cards require fulfillment details with a shipping address. Use when a user needs a physical card for in-person transactions.
Input parameters
Unique identifier (UUID) of the card owner. This user will be assigned as the cardholder.
Business entity UUID to associate with the card. If not provided, defaults to entity associated with user's location.
Fulfillment details for the physical card.
Cosmetic display name for the card (e.g., 'Business Travel Card', 'T&E'). Required by the API.
Set to true to create a temporary card. Defaults to false.
Card program ID to use for the card. One of spending_restrictions or card_program_id must be provided.
Unique value to recognize subsequent retries of the same request. Use a random UUID to avoid collisions.
Spending restrictions for the physical card.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_REACTIVATE_ACCOUNTING_CONNECTIONTool to reactivate a previously unlinked accounting connection by changing its status back to linked. This preserves all previous accounting field configurations and settings. Use when you need to restore a disconnected accounting integration. The business must not have any other active accounting connections.
Input parameters
The UUID of the accounting connection to reactivate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_REACTIVATE_USERTool 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
The unique identifier (UUID) of the user to reactivate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_SUBMIT_REIMBURSEMENT_RECEIPTTool to upload a receipt for a reimbursement. Use when submitting receipts for out-of-pocket expenses. If reimbursement_id is provided, attaches the receipt to an existing reimbursement; otherwise creates a new draft reimbursement via OCR.
Input parameters
Receipt file to upload. FileUploadable object where 'name' should be the receipt filename (e.g., 'receipt.pdf', 'receipt.jpg').
UUID of the user to create the reimbursement for
Unique value to prevent duplicate uploads. Use a UUID to avoid collisions
Optional UUID of existing reimbursement to attach receipt to. If not provided, a new draft reimbursement will be created via OCR
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_SUSPEND_CARDTool to suspend a card by creating an async task that locks the card from use. Use when you need to temporarily disable a card. The suspension is revertable.
Input parameters
The unique identifier of the card to suspend
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_TERMINATE_CARDTool to permanently terminate a Ramp card. This action creates an async task to terminate the card and is irreversible. Use when you need to permanently deactivate a card. The response contains a task ID that can be used to check the termination status.
Input parameters
The unique identifier of the card to terminate permanently
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_FIELDTool 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 of the custom accounting field.
UUID of the custom accounting field to update (ramp_id).
Update the name of the custom accounting field on Ramp.
Update the is_splittable of the custom accounting field on Ramp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_INVENTORY_ITEM_OPTIONSTool to update an inventory item option in Ramp's accounting system. Use when you need to modify an existing inventory item option's details.
Input parameters
The updated name of the inventory item option
The Ramp UUID of the inventory item option to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_TAX_CODETool to update tax code accounting field. Use when you need to modify the name or display name of the tax code field in Ramp's accounting system.
Input parameters
Name of the tax code field.
Display name of the tax code field on Ramp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_TAX_CODE_OPTIONSTool to update a tax code option in Ramp. Use when you need to modify the name or associated tax rates of an existing tax code option.
Input parameters
The name of the tax code option.
The unique identifier (UUID) of the tax code option to update
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_TAX_RATETool 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 of the tax rate
The tax rate percentage expressed as a decimal (e.g. 0.10 for 10%, 0.15 for 15%)
The unique Ramp ID (UUID) of the tax rate to update
The Ramp ID (UUID) of the GL account to associate with this tax rate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_ACCOUNTING_VENDORTool to update an accounting vendor in Ramp. Use when you need to modify vendor details such as name or code, or reactivate a deleted vendor.
Input parameters
Code of the vendor. Provide an empty string to reset the code.
Name of the vendor to update
The unique identifier (ramp_id UUID) of the vendor to update. This is the Ramp-internal UUID, not the external ERP system ID.
Set to true to reactivate a deleted vendor. Only the value true is accepted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_CARD_LIMITTool for updating spending limits on a card. Note: This returns the limits associated with the card. The actual update might require using the limit ID directly via PATCH /limits/{limit_id}.
Input parameters
New spending limit amount in cents
The ID of the card to update limits for
Spending limit interval: DAILY, WEEKLY, MONTHLY, QUARTERLY, YEARLY, or TOTAL
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_DEPARTMENTTool for updating an existing department in your Ramp organization. Useful for reorganizing departmental structure or renaming departments.
Input parameters
New department code/identifier
New name for the department
ID of the department to update
New parent department ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_LIMITSTool to update a spending limit in Ramp. Use when you need to modify limit settings such as display name, spending restrictions, permitted spend types, or user assignments.
Input parameters
Change the user of the limit. Must be a valid UUID.
Change the display name of the limit.
Dictates whether the spend limit is shareable among multiple users.
Unique identifier of the spending limit to update.
Set accounting rules for all card transactions and reimbursements (if applicable) for the given spend limit.
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 for the limit.
Spending restrictions for the limit.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPDATE_USERTool to update an existing user in your Ramp organization. Use when modifying user information such as name, department, role, or manager assignments.
Input parameters
User role in the Ramp organization.
Unique identifier of the user to update (UUID format)
Last name of the user
First name of the user
Whether the employee is a manager
Unique identifier of the employee's location (UUID format)
Whether to automatically promote the user's manager to manager role
Unique identifier of the employee's department (UUID format)
Unique identifier of the employee's direct manager (UUID format). Set to null to remove manager assignment.
The date when the user is scheduled to be deactivated (YYYY-MM-DD format). Set to null to clear the scheduled deactivation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPLOAD_NEW_OPTIONSTool for uploading new options for a given accounting field.
Input parameters
A list of field options for a given custom accounting field.
UUID of the custom accounting field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPLOAD_TAX_CODE_OPTIONSTool to upload tax code options to Ramp. Use when you need to create or update tax codes in the accounting system. Requires an active tax code accounting field for the accounting connection.
Input parameters
A list of tax code options to upload. Must contain at least 1 option and at most 500 options per API call.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
RAMP_UPLOAD_TAX_RATESTool to batch upload tax rates to Ramp. Supports up to 500 tax rates per call with all-or-nothing validation. Use when you need to create tax rates in Ramp's accounting system. Ensure data is sanitized and tax rates do not already exist before uploading.
Input parameters
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 52 agents privately built on Nagent that already use Ramp.
Build on Nagent
Connect Ramp to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Ramp, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Ramp is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Ramp is connected, you configure its 88 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Ramp steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Ramp event fires, the agent kicks off automatically.
Every Ramp action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Ramp ships with 88 pre-built accounting actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Ramp together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Ramp-based workflows tailored to your business.