Skip to main content

Ramp Component

Ramp is a spend management platform focused on automating accounts payable and procurement processes. Use the Ramp component to manage transactions related to vendors, bills, reimbursements and more.

Component key: ramp ·
· Changelog ↓

Description​

Ramp is a spend management platform focused on automating accounts payable and procurement processes.

Use the Ramp component to manage transactions related to vendors, bills, reimbursements and more.

API Documentation:​

This component was built using the Ramp REST API V1 Reference.

Connections​

OAuth 2.0​

key: ramp-oauth2

Create an OAuth application:

Registering your application in the Ramp developer dashboard is the first step of building an integration based on Ramp API:

  1. From the Ramp developer settings page, click on Create new app to register a new application.
  2. Now you have registered a new application. Click into it and configure the following parameters:
    1. Client ID and client secret: Credentials for your application; store securely.
    2. App name and description
    3. Grant types: A list of grant types that the application may use to get access token. See authorization guide for more information.
    4. Scopes: Defines scopes that may be granted to access token.
    5. Redirect URIs: Enterhttps://oauth2.prismatic.io/callback.

Supply the following values to the OAuth 2.0 connection:

  • Client ID
  • Client Secret
  • Scopes
    • Recommended Scopes (space delimited): bills:read bills:write accounting:read accounting:write transactions:read reimbursements:read departments:read departments:write entities:read locations:read locations:write
InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Ramp

Client ID
Client Secret
Scopes

A comma-delimited set of one or more scopes to get the user's permission to access. Refer to https://docs.ramp.com/developer-api/v1/authorization/scopes

accounting:read accounting:write bills:read business:read cards:read cards:write cashbacks:read departments:read departments:write entities:read leads:read leads:write limits:read limits:write locations:read locations:write memos:read merchants:read receipt_integrations:read receipt_integrations:write receipts:read reimbursements:read spend_programs:read spend_programs:write statements:read transactions:read transfers:read users:read users:write
Token URL

The OAuth 2.0 Token URL for Ramp

Triggers​

New and Updated Records​

Checks for new and updated records in a selected Ramp resource type on a configured schedule. | key: pollChangesTrigger

InputNotesExample
Connection
Resource Type

The type of resource to poll for new and updated records.

Show New Records

Include newly created records in trigger results.

true
Show Updated Records

Include updated records in trigger results.

true

This trigger polls the Ramp API for new and updated records on a scheduled basis.

How It Works​

  1. The trigger runs on the configured schedule
  2. It fetches records from Ramp for the selected resource type — timestamp-based resources are queried using created_at and/or updated_at filters anchored to the last poll time; ID-based resources fetch all records and compare against the known ID set
  3. Records are categorized as created or updated based on their timestamps relative to the last poll time, or as created only for ID-based resources where update detection is not supported
  4. The trigger updates its internal state after each poll

Configuration​

Configure the following inputs:

  • Connection: The Ramp connection used to authenticate API requests
  • Resource Type: The type of records to monitor — Transactions, Bills, Reimbursements, Vendors, Departments, Locations, Business Entities, General Ledger Accounts, or Custom Accounting Fields
  • Show New Records: When enabled, includes newly created records in the results. Defaults to true
  • Show Updated Records: When enabled, includes modified records in the results. Defaults to true

Returned Data​

The trigger returns an object with two arrays — created for new records and updated for modified records.

Example Response
{
  "data": {
    "created": [
      {
        "id": "txn_01H9ZQ2KBCDEF12345",
        "amount": 4250,
        "currency_code": "USD",
        "merchant_name": "Acme Supplies",
        "user_transaction_time": "2024-01-16T10:30:00Z"
      }
    ],
    "updated": [
      {
        "id": "reimb_01H9ZQ2KBCDEF67890",
        "amount": 125,
        "currency_code": "USD",
        "created_at": "2024-01-10T09:00:00Z",
        "updated_at": "2024-01-16T14:22:00Z"
      }
    ]
  }
}

Notes​

  • Departments, Locations, and Business Entities use ID-based change detection — the Show Updated Records toggle has no effect for these resource types, as update detection is not supported
  • Timestamp-based resource types (Transactions, Bills, Reimbursements, Vendors, General Ledger Accounts, Custom Accounting Fields) support both new and updated record detection
  • Refer to the Ramp API documentation for rate limit details and available fields per resource type

Data Sources​

Select Bill​

Select a Bill from a dropdown menu. | key: selectBill | type: picklist

InputNotesExample
Connection
Example Payload for Select Bill⤓
Loading…

Select Business Entity​

Select a Business Entity from a dropdown menu. | key: selectBusinessEntity | type: picklist

InputNotesExample
Connection
Example Payload for Select Business Entity⤓
Loading…

Select Custom Accounting Field​

Select a custom accounting field from a dropdown menu. | key: selectCustomAccountingField | type: picklist

InputNotesExample
Connection
Example Payload for Select Custom Accounting Field⤓
Loading…

Select Custom Accounting Field Option​

Select a custom accounting field option from a dropdown menu for the specified field. | key: selectCustomAccountingFieldOption | type: picklist

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Select Custom Accounting Field Option⤓
Loading…

Select Department​

Select a Department from a dropdown menu. | key: selectDepartment | type: picklist

InputNotesExample
Connection
Example Payload for Select Department⤓
Loading…

Select General Ledger Account​

Select an General Ledger Account from a dropdown menu | key: selectLedgerAccount | type: picklist

InputNotesExample
Connection
Example Payload for Select General Ledger Account⤓
Loading…

Select Location​

Select a Location from a dropdown menu. | key: selectLocation | type: picklist

InputNotesExample
Connection
Example Payload for Select Location⤓
Loading…

Select Reimbursement​

Select a reimbursement from a dropdown menu. | key: selectReimbursement | type: picklist

InputNotesExample
Connection
Example Payload for Select Reimbursement⤓
Loading…

Select Transaction​

Select a transaction from a dropdown menu. | key: selectTransaction | type: picklist

InputNotesExample
Connection
Example Payload for Select Transaction⤓
Loading…

Select Vendor​

Select a Vendor from a dropdown menu. | key: selectVendor | type: picklist

InputNotesExample
Connection
Example Payload for Select Vendor⤓
Loading…

Actions​

Create Custom Accounting Field​

Create a custom accounting field | key: createCustomAccountingField

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to create

96bb7007-eec5-430f-8d09-e033cbc000c2
Input Type

The input type could be SINGLE_CHOICE, BOOLEAN or FREE_FORM_TEXT

Is Splitable

If set to True, the accounting field can be used to annotate split line items

Name

The name of the custom accounting field to create

Amazon
Example Payload for Create Custom Accounting Field⤓
Loading…

Create Department​

Create a new department | key: createDepartment

InputNotesExample
Connection
Name

The name of the department

Amazon
Example Payload for Create Department⤓
Loading…

Create Location​

Create a new location | key: createLocation

InputNotesExample
Connection
Entity ID

The ID of the entity to create the location

96bb7007-eec5-430f-8d09-e033cbc000c2
Name

The name of the location

Amazon
Example Payload for Create Location⤓
Loading…

Delete Custom Accounting Field​

Delete a custom accounting field | key: deleteCustomAccountingField

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to delete

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Delete Custom Accounting Field⤓
Loading…

Delete Custom Accounting Field Option​

Delete a custom accounting field option | key: deleteCustomAccountingFieldOption

InputNotesExample
Connection
Custom Accounting Field Option ID

The ID of the custom accouting field option to delete

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Delete Custom Accounting Field Option⤓
Loading…

Delete General Ledger Account​

Delete a general ledger account | key: deleteGeneralLedgerAccount

InputNotesExample
Connection
General Ledger Account ID

The ID of the general ledger account to delete

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Delete General Ledger Account⤓
Loading…

Delete Vendor​

Delete a vendor | key: deleteVendor

InputNotesExample
Connection
Vendor ID

The ID of the vendor to delete

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Delete Vendor⤓
Loading…

Get Bill​

Retrieve a bill by ID | key: getBill

InputNotesExample
Bill ID

The ID of the bill to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Connection
Example Payload for Get Bill⤓
Loading…

Get Business Entity​

Retrieve a business entity by ID | key: getBusinessEntity

InputNotesExample
Business Entity ID

The ID of the business entity to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Connection
Example Payload for Get Business Entity⤓
Loading…

Get Custom Accounting Field​

Retrieve a custom accounting field by ID | key: getCustomAccountingField

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Custom Accounting Field⤓
Loading…

Get Custom Accounting Field Option​

Retrieve a custom accounting field option by ID | key: getCustomAccountingFieldOption

InputNotesExample
Connection
Custom Accounting Field Option ID

The ID of the custom field option to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Custom Accounting Field Option⤓
Loading…

Get Department​

Retrieve a department by ID | key: getDepartment

InputNotesExample
Connection
Department ID

The ID of the department to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Department⤓
Loading…

Get General Ledger Account​

Retrieve a general ledger account by ID | key: getGeneralLedgerAccount

InputNotesExample
Connection
General Ledger Account ID

The ID of the general ledger account to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get General Ledger Account⤓
Loading…

Get Location​

Retrieve a location by ID | key: getLocation

InputNotesExample
Connection
Location ID

The ID of the location to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Location⤓
Loading…

Get Reimbursement​

Retrieve a reimbursement by ID | key: getReimbursement

InputNotesExample
Connection
Reimbursement ID

The ID of the reimbursement to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Reimbursement⤓
Loading…

Get Transaction​

Retrieve a transaction by ID | key: getTransaction

InputNotesExample
Connection
Transaction ID

The ID of the transaction to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Transaction⤓
Loading…

Get Vendor​

Retrieve a vendor by ID | key: getVendor

InputNotesExample
Connection
Vendor ID

The ID of the vendor to retrieve

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Get Vendor⤓
Loading…

List Bills​

Retrieve a list of all bills | key: listBills

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Bills⤓
Loading…

List Business Entities​

Retrieve a list of all business entities | key: listBusinessEntities

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Business Entities⤓
Loading…

List Custom Accounting Field​

List custom accounting fields | key: listCustomAccountingField

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Custom Accounting Field⤓
Loading…

List Custom Accounting Field Options​

List options for a given custom accounting field | key: listCustomAccountingFieldOptions

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to list options for

96bb7007-eec5-430f-8d09-e033cbc000c2
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Custom Accounting Field Options⤓
Loading…

List Departments​

Retrieve a list of all Departments | key: listDepartments

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Departments⤓
Loading…

List General Ledger Accounts​

Retrieve a list of all general ledger accounts | key: listGeneralLedgerAccounts

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List General Ledger Accounts⤓
Loading…

List Locations​

Retrieve a list of all locations | key: listLocations

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Locations⤓
Loading…

List Reimbursements​

Retrieve a list of all reimbursements | key: listReimbursements

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Reimbursements⤓
Loading…

List Transactions​

Retrieve a list of all transactions | key: listTransactions

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Transactions⤓
Loading…

List Vendors​

Retrieve a list of all vendors | key: listVendors

InputNotesExample
Connection
Custom Query Params

Custom query parameters to be included in the request

key1=value1
Fetch All

If true, will fetch all results

false
Page Size

Number of results to retrieve per page. Default is 50

50
Start

The starting point for the list of results. Is fetchAll is true, this option will be ignored

1
Example Payload for List Vendors⤓
Loading…

Post Sync Status​

This endpoint allows customers to notify Ramp of a list of sync results | key: postSyncStatus

InputNotesExample
Connection
Failed Syncs

A list of objects that failed to be synced

[
  {
    "error": {
      "message": "The account period has closed and the account books cannot be updated."
    },
    "id": "d471d830-2e73-4082-8a75-68540f83e86e"
  }
]
Idempotency Key

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

d471d830-2e73-4082-8a75-68540f83e86e
Successful Syncs

A list of objects that failed to be synced

[
  {
    "id": "5a58eb94-a583-458f-810d-c794f32f2f90",
    "reference_id": "d8573713-a97d-4119-bdd7-b69c318df9bb"
  },
  {
    "id": "bb037f47-c664-46f9-afa7-cc68cbcf5a23",
    "reference_id": "83283a15-c0a0-4105-9724-2fcfefa9924f"
  }
]
Sync Type

The type of object to sync

TRANSACTION_SYNC

Raw Request​

Send raw HTTP request to Ramp API | key: rawRequest

InputNotesExample
Connection
Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/departments), The base URL is already included (https://api.ramp.com/developer/v1/). For example, to connect to https://api.ramp.com/developer/v1/departments, only /departments is entered in this field. e.g. /departments

/departments
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

Update Custom Accounting Field​

Update an existing custom accounting field | key: updateCustomAccountingField

InputNotesExample
Connection
Custom Accounting Field ID

The ID of the custom accounting field to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Is Splitable

If set to True, the accounting field can be used to annotate split line items

Name

The name of the custom accounting field

Amazon
Example Payload for Update Custom Accounting Field⤓
Loading…

Update Custom Accounting Field Option​

Update an existing custom accounting field option | key: updateCustomAccountingFieldOption

InputNotesExample
Connection
Custom Accounting Field Option ID

The ID of the custom accounting field option to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Reactivate

Reactivate a deleted custom field option

Value

The value of the custom accounting field option

Sales & Marketing
Example Payload for Update Custom Accounting Field Option⤓
Loading…

Update Department​

Update a department by ID | key: updateDepartment

InputNotesExample
Connection
Department ID

The ID of the department to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Name

The updated name of the department

Amazon
Example Payload for Update Department⤓
Loading…

Update General Ledger Account​

Update an existing general ledger account | key: updateGeneralLedgerAccount

InputNotesExample
Code

The code of the general ledger account; you could provide an empty string if you want to reset the remote code

19566
Connection
General Ledger Account ID

The ID of the general ledger account to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Name

Name of the general ledger account

Amazon
Reactivate

Reactivate a deleted general ledger account

Subsidiaries

IDs of a list of subsidiaries which a general ledger account can be used with. The Ramp-assigned IDs should be used here. you could provide an empty list if you want to reset the subsidiaries list for this general ledger account

[
  "d4fb347a-e24d-46aa-bdbd-f51ee6f3938b",
  "dc9e25cd-15f9-4a90-9de7-d05207641300"
]
Example Payload for Update General Ledger Account⤓
Loading…

Update Location​

Update an existing location | key: updateLocation

InputNotesExample
Connection
Entity ID

The ID of the entity to update the location

96bb7007-eec5-430f-8d09-e033cbc000c2
Location ID

The ID of the location to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Name

The updated name of the location

Amazon
Example Payload for Update Location⤓
Loading…

Update Vendor​

Update an existing vendor | key: updateVendor

InputNotesExample
Code

Code of the vendor; you could provide an empty string to reset the remote code

19566
Connection
Name

Name of a vendor

Amazon
Reactivate

Reactivate a deleted vendor

Subsidiaries

IDs of a list of subsidiaries associated with the vendor. The Ramp-assigned IDs should be used here. You could provide an empty list to reset the subsidiaries list

[
  "d4fb347a-e24d-46aa-bdbd-f51ee6f3938b",
  "dc9e25cd-15f9-4a90-9de7-d05207641300"
]
Vendor ID

The ID of the vendor to update

96bb7007-eec5-430f-8d09-e033cbc000c2
Example Payload for Update Vendor⤓
Loading…

Upload Custom Accounting Field Option​

Upload a new custom accounting field option | key: uploadCustomAccountingFieldOption

InputNotesExample
Connection
Custom Accounting Field Option ID

The ID of the custom accounting field option for which to upload options

96bb7007-eec5-430f-8d09-e033cbc000c2
Options

A list of field options for a given custom accounting field

[
  {
    "id": "418",
    "value": "Engineering & Design"
  },
  {
    "id": "514",
    "value": "Sales & Marketing"
  }
]
Example Payload for Upload Custom Accounting Field Option⤓
Loading…

Changelog​

2026-04-30​

Updated spectral version

2026-04-21​

Added New and Updated Records polling trigger that checks for new and updated transactions, bills, reimbursements, vendors, and other financial records in Ramp on a configured schedule

2026-03-13​

Removed the Debug Request input from all action inputs. Debug logging is now controlled internally and no longer appears as a configurable field in actions.

2026-03-05​

Added inline data sources for transactions, reimbursements, custom accounting fields, and custom accounting field options to enhance data selection capabilities