Ramp

Learn how to use Ramp with Composio

Overview

Enum

RAMP

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
base_url
stringRequired
authorizationUrl
stringRequired
oauth_redirect_uri
string
scopes
string
access_token
string

Actions

Tool for creating a new department in your ramp organization. perfect for setting up organizational structure and expense categorization.

Action Parameters

name
stringRequired
parent_department_id
string

Action Response

data
object
error
string
successful
boolean
Tool for creating a new custom accounting field. note: this operation requires elevated permissions not available in the demo api.

Action Parameters

id
stringRequired
input_type
stringRequired
is_required_for
array
is_splittable
boolean
name
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool for fetching a custom accounting field.

Action Parameters

field_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Get all the transactions.

Action Parameters

accounting_field_selection_id
string
approval_status
string
awaiting_approval_by_user_id
string
card_id
string
department_id
string
entity_id
string
from_date
string
has_no_sync_commits
boolean
include_merchant_data
boolean
limit_id
string
location_id
string
max_amount
string
merchant_id
string
min_amount
string
order_by_amount_asc
boolean
order_by_amount_desc
boolean
order_by_date_asc
boolean
order_by_date_desc
boolean
page_size
integerDefaults to 20
requires_memo
boolean
sk_category_id
string
spend_program_id
string
start
string
state
string
statement_id
string
sync_ready
boolean
sync_status
string
synced_after
string
to_date
string
trip_id
string
user_id
string

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

card_id
stringRequired

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

department_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool for fetching cards assigned to you, including physical and virtual cards. useful for checking card status, limits, and managing your payment methods.

Action Parameters

card_type
string
page_size
integerDefaults to 50
page_token
string
state
string

Action Response

data
object
error
string
successful
boolean
Get my transactions.

Action Parameters

accounting_field_selection_id
string
approval_status
string
awaiting_approval_by_user_id
string
card_id
string
department_id
string
entity_id
string
from_date
string
has_no_sync_commits
boolean
include_merchant_data
boolean
limit_id
string
location_id
string
max_amount
string
merchant_id
string
min_amount
string
order_by_amount_asc
boolean
order_by_amount_desc
boolean
order_by_date_asc
boolean
order_by_date_desc
boolean
page_size
integerDefaults to 20
requires_memo
boolean
sk_category_id
string
spend_program_id
string
start
string
state
string
statement_id
string
sync_ready
boolean
sync_status
string
synced_after
string
to_date
string
trip_id
string
user_id
string

Action Response

data
object
error
string
successful
boolean
Tool for retrieving statement details or downloading statements. supports json, pdf, and csv formats for financial reporting.

Action Parameters

format
stringDefaults to json
statement_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool for retrieving complete details of a specific transaction. includes merchant details, receipts, accounting codes, and dispute information.

Action Parameters

transaction_id
stringRequired

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

vendor_id
stringRequired

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

card_program_id
string
display_name
string
memo
string
spending_restrictions
object
user_id
stringRequired

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

card_program_id
string
display_name
string
entity_id
string
is_activated
boolean
is_terminated
boolean
page_size
integerDefaults to 20
start
string
user_id
string

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

page_size
integerDefaults to 20
start
string

Action Response

data
object
error
string
successful
boolean
Tool for listing all statements with filtering options. perfect for financial reporting and reconciliation workflows.

Action Parameters

from_date
string
page_size
integerDefaults to 20
start
string
to_date
string

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

department_id
string
email
string
employee_id
string
entity_id
string
location_id
string
page_size
integerDefaults to 20
role
string
start
string

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

from_created_at
string
is_active
boolean
name
string
page_size
integerDefaults to 20
sk_category_ids
string
start
string
vendor_owner_id
string

Action Response

data
object
error
string
successful
boolean
Tool for listing options for a given accounting field.

Action Parameters

field_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Search transactions with filters.

Action Parameters

accounting_field_selection_id
string
approval_status
string
awaiting_approval_by_user_id
string
card_id
string
department_id
string
entity_id
string
from_date
string
has_no_sync_commits
boolean
include_merchant_data
boolean
limit_id
string
location_id
string
max_amount
string
merchant_id
string
min_amount
string
order_by_amount_asc
boolean
order_by_amount_desc
boolean
order_by_date_asc
boolean
order_by_date_desc
boolean
page_size
integerDefaults to 20
query
stringRequired
requires_memo
boolean
sk_category_id
string
spend_program_id
string
start
string
state
string
statement_id
string
sync_ready
boolean
sync_status
string
synced_after
string
to_date
string
trip_id
string
user_id
string

Action Response

data
object
error
string
successful
boolean
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}.

Action Parameters

amount
integerRequired
card_id
stringRequired
interval
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool for updating an existing department in your ramp organization. useful for reorganizing departmental structure or renaming departments.

Action Parameters

code
string
department_id
stringRequired
name
string
parent_department_id
string

Action Response

data
object
error
string
successful
boolean
Tool for uploading new options for a given accounting field.

Action Parameters

field_id
stringRequired
options
arrayRequired

Action Response

data
object
error
string
successful
boolean