Team
Shared credential for production and unattended runs.
Connect Ramp with Hookshot™ and your stack
Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business
Tools and triggers
What Agents can do in Ramp
Available tools and events after Ramp is connected.
-
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…
-
Create Department
Tool for creating a new department in your Ramp organization. Perfect for setting up organizational structure and expense categorization.
-
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…
-
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.
-
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.
-
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…
-
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.
-
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.
-
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.
-
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…
-
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…
-
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…
-
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.
-
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.
-
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.
-
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.
-
Delete Accounting Vendor
Tool to delete an accounting vendor from Ramp. Use when you need to remove a vendor from the accounting system.
-
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.
-
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.
-
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…
-
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.
-
Delete Webhook Subscription
Tool 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.
-
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.
-
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.
-
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.
-
Fetch Custom Accounting Field
Tool for fetching a custom accounting field.
-
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.
-
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.
-
Get All Transactions
Get all the transactions.
-
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…
-
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.
-
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.
-
Get Department
Tool 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.
-
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.
-
Get Memo
Tool to fetch a transaction memo. Use when you need to retrieve the memo text associated with a specific transaction.
-
Get Reimbursement Details
Tool 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…
-
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.
-
Get Statement
Tool for retrieving statement details or downloading statements. Supports JSON, PDF, and CSV formats for financial reporting.
-
Get Transaction Details
Tool for retrieving complete details of a specific transaction. Includes merchant details, receipts, accounting codes, and dispute information.
-
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.
-
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.
-
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…
-
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.
-
Issue Virtual Card
Tool for issuing virtual cards to users instantly. Creates cards with customizable spending limits and restrictions. Returns full card details including card number and CVV.
-
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.
-
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.
-
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.
-
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…
-
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.
-
List Departments
Tool 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.
-
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.
-
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.
-
List Reimbursements
Tool for listing reimbursements with comprehensive filtering options. Returns reimbursement details including amounts, status, sync information, and associated entities. Use this to analyze reimbursement patterns…
-
List Statements
Tool for listing all statements with filtering options. Perfect for financial reporting and reconciliation workflows.
-
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…
-
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.
-
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.
-
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.
-
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.
-
List Webhooks
Tool 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.
-
Options for Custom Accounting Field
Tool for listing options for a given accounting field.
-
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…
-
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…
-
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.
-
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…
-
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.
-
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…
-
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.
-
Update Accounting Inventory Item Option
Tool to update an inventory item option in Ramp's accounting system. Use when you need to modify an existing inventory item option's details.
-
Update Accounting Tax Code
Tool 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.
-
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.
-
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.
-
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.
-
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.
-
Update Card Spending Limit
Tool 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}.
-
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.
-
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.
-
Update Department
Tool for updating an existing department in your Ramp organization. Useful for reorganizing departmental structure or renaming departments.
-
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.
-
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.
-
Update Spending Limit
Tool 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.
-
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.
-
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.
-
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…
-
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…
-
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.
-
Upload New Options for Custom Accounting Field
Tool for uploading new options for a given accounting field.
-
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.
Setup
Connect Ramp in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
