> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/ramp.md).

# Ramp

Connect Ramp to automate business spending workflows.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Ramp      | OAuth sign-in  |

### Ramp

Connect Ramp to manage business spending workflows.

#### Set up in Ramp

1. Use a Ramp account with access to the records and operations that your workflow needs.
2. Register or select the OAuth application described in the fields below. Add the redirect URI displayed in StackAI to that application and retain its client ID and secret, where required.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Ramp**.
2. Complete the connector configuration below. If you do not have access to these settings, ask your StackAI administrator to configure the connector.
3. Complete the fields marked for use before sign-in.
4. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
5. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connector configuration**

| StackAI field | Required  | What to enter                                                                                                                       |
| ------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| OAuth Scopes  | Read-only | Scopes granted to the StackAI Ramp integration. This value is shown for reference; it is not an editable credential.                |
| Client ID     | Yes       | Client ID from your Ramp OAuth application.                                                                                         |
| Client Secret | Yes       | Client secret from your Ramp OAuth application.                                                                                     |
| Redirect URI  | Read-only | Use this redirect URI when configuring your OAuth application. This value is shown for reference; it is not an editable credential. |

**Connection fields**

| StackAI field | Required                 | What to enter                                                                                         |
| ------------- | ------------------------ | ----------------------------------------------------------------------------------------------------- |
| Environment   | Optional / as applicable | Choose the Ramp production or sandbox environment before connecting. Complete this before signing in. |

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Ramp** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### List transactions

Find Ramp card transactions for review, categorization, or audit workflows.

**Required permissions:** `transactions:read`.

#### Inputs

| Field                | Type            | Required | Description                                                                                                                                    |
| -------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Transaction state    | select (string) | No       | Only return transactions in this state. Available values: All transactions, Cleared, Completion, Declined, Error, Pending, Pending initiation. |
| Cardholder           | select (string) | No       | Only return transactions for this cardholder. Options load from the selected connection.                                                       |
| From date and time   | datetime        | No       | Only return transactions at or after this time.                                                                                                |
| To date and time     | datetime        | No       | Only return transactions before this time.                                                                                                     |
| Show advanced fields | boolean         | No       | Show amount, entity, pagination, and result-limit filters. Default: false.                                                                     |
| Minimum amount       | number          | No       | Only return transactions at or above this US dollar amount.                                                                                    |
| Maximum amount       | number          | No       | Only return transactions at or below this US dollar amount.                                                                                    |
| Business entity      | select (string) | No       | Only return transactions for this business entity. Options load from the selected connection.                                                  |
| Cursor               | string          | No       | Continue from a previous page of results.                                                                                                      |
| Maximum results      | integer         | No       | Maximum number of transactions to return. Minimum: 2. Maximum: 2000. Default: 100.                                                             |

#### Outputs

| Field        | Type          | Description                                                  |
| ------------ | ------------- | ------------------------------------------------------------ |
| Transactions | object\_array | Matching Ramp transaction summaries.                         |
| Next cursor  | string        | Pass this cursor to continue, if more results are available. |

### Create bill

Create and auto-approve a vendor bill in Ramp.

**Required permissions:** `bills:write`.

#### Inputs

| Field            | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vendor           | select (string) | Yes      | Vendor that issued the bill. Options load from the selected connection.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Business entity  | select (string) | Yes      | Business entity responsible for the bill. Options load from the selected connection.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Invoice number   | string          | Yes      | Invoice number shown by the vendor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Invoice currency | select (string) | Yes      | Three-letter currency used on the invoice. Available values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLL, SLE, SOS, SRD, STD, SVC, SZL, THB, TJS, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USDC, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW. Default: USD. |
| Issue date       | date            | Yes      | Date the vendor issued the invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Due date         | date            | Yes      | Date payment is due to the vendor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Invoice amount   | number          | Yes      | Total amount for a single invoice line item.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Memo             | textarea        | No       | Internal context for the bill.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

#### Outputs

| Field | Type   | Description                           |
| ----- | ------ | ------------------------------------- |
| Bill  | object | The created, auto-approved Ramp bill. |

### List vendors

Find Ramp vendors and their IDs for bill workflows.

**Required permissions:** `vendors:read`.

#### Inputs

| Field           | Type    | Required | Description                                                                   |
| --------------- | ------- | -------- | ----------------------------------------------------------------------------- |
| Cursor          | string  | No       | Continue from a previous page of vendors.                                     |
| Maximum results | integer | No       | Maximum number of vendors to return. Minimum: 2. Maximum: 2000. Default: 100. |

#### Outputs

| Field       | Type          | Description                                                  |
| ----------- | ------------- | ------------------------------------------------------------ |
| Vendors     | object\_array | Ramp vendor summaries for bill workflows.                    |
| Next cursor | string        | Pass this cursor to continue, if more results are available. |

### List business entities

Find Ramp business entities and their IDs for spending workflows.

**Required permissions:** `entities:read`.

#### Inputs

| Field           | Type    | Required | Description                                                                    |
| --------------- | ------- | -------- | ------------------------------------------------------------------------------ |
| Cursor          | string  | No       | Continue from a previous page of entities.                                     |
| Maximum results | integer | No       | Maximum number of entities to return. Minimum: 2. Maximum: 2000. Default: 100. |

#### Outputs

| Field             | Type          | Description                                                  |
| ----------------- | ------------- | ------------------------------------------------------------ |
| Business entities | object\_array | Matching Ramp business entity summaries.                     |
| Next cursor       | string        | Pass this cursor to continue, if more results are available. |

### List reimbursements

Find employee reimbursements for approval, payout, or accounting workflows.

**Required permissions:** `reimbursements:read`.

#### Inputs

| Field                | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Direction            | select (string) | No       | Whether Ramp pays the employee or the employee repays Ramp. Available values: Ramp pays employee, Employee repays Ramp. Default: BUSINESS\_TO\_USER.                                                                                                                                                                                                                                                                             |
| Reimbursement state  | select (string) | No       | Only return reimbursements in this Ramp state. Available values: Approved, Awaiting Export, Awaiting Payment, Awaiting Push Payment, Canceled, Deleted, Draft, Exported, Export Failed, Export Initiated, Export Marked As Failed, Export Successful, Failed Reimbursement, Init, Manually Reimbursed, Missing Ach, Pending, Processing, Push Payment Failed, Push Payment Initiated, Reimbursed, Reimbursed Via Push, Rejected. |
| Employee             | select (string) | No       | Only return reimbursements for this employee. Options load from the selected connection.                                                                                                                                                                                                                                                                                                                                         |
| Show advanced fields | boolean         | No       | Show entity, pagination, and result-limit filters. Default: false.                                                                                                                                                                                                                                                                                                                                                               |
| Business entity      | select (string) | No       | Only return reimbursements for this business entity. Options load from the selected connection.                                                                                                                                                                                                                                                                                                                                  |
| Cursor               | string          | No       | Continue from a previous page of results.                                                                                                                                                                                                                                                                                                                                                                                        |
| Maximum results      | integer         | No       | Maximum number of reimbursements to return. Minimum: 2. Maximum: 2000. Default: 100.                                                                                                                                                                                                                                                                                                                                             |

#### Outputs

| Field          | Type          | Description                                                  |
| -------------- | ------------- | ------------------------------------------------------------ |
| Reimbursements | object\_array | Matching Ramp reimbursement summaries.                       |
| Next cursor    | string        | Pass this cursor to continue, if more results are available. |

### List users

Find Ramp employees and their IDs for transaction and reimbursement workflows.

**Required permissions:** `users:read`.

#### Inputs

| Field           | Type    | Required | Description                                                                 |
| --------------- | ------- | -------- | --------------------------------------------------------------------------- |
| Cursor          | string  | No       | Continue from a previous page of users.                                     |
| Maximum results | integer | No       | Maximum number of users to return. Minimum: 2. Maximum: 2000. Default: 100. |

#### Outputs

| Field       | Type          | Description                                                  |
| ----------- | ------------- | ------------------------------------------------------------ |
| Users       | object\_array | Ramp employee summaries for workflow inputs.                 |
| Next cursor | string        | Pass this cursor to continue, if more results are available. |

## Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

### On transaction update

Trigger a workflow when Ramp authorizes, clears, declines, or marks a transaction ready for review.

Ramp signs deliveries sent to this URL automatically: {{webhook\_url}}

**Required permissions:** `transactions:read`.

#### Event inputs

| Field          | Type   | Required | Description                                      |
| -------------- | ------ | -------- | ------------------------------------------------ |
| Transaction ID | string | Yes      | Ramp identifier for the updated transaction.     |
| Event type     | string | Yes      | Ramp transaction event that caused this trigger. |
| Event time     | string | No       | Ramp event creation time, when supplied.         |

#### Outputs

| Field          | Type   | Description                                      |
| -------------- | ------ | ------------------------------------------------ |
| Transaction ID | string | Ramp identifier for the updated transaction.     |
| Event type     | string | Ramp transaction event that caused this trigger. |
| Event time     | string | Ramp event creation time, when supplied.         |

### On bill update

Trigger a workflow when Ramp creates, approves, rejects, pays, or updates a bill.

Ramp signs deliveries sent to this URL automatically: {{webhook\_url}}

**Required permissions:** `bills:read`.

#### Event inputs

| Field      | Type   | Required | Description                               |
| ---------- | ------ | -------- | ----------------------------------------- |
| Bill ID    | string | Yes      | Ramp identifier for the updated bill.     |
| Event type | string | Yes      | Ramp bill event that caused this trigger. |
| Event time | string | No       | Ramp event creation time, when supplied.  |

#### Outputs

| Field      | Type   | Description                               |
| ---------- | ------ | ----------------------------------------- |
| Bill ID    | string | Ramp identifier for the updated bill.     |
| Event type | string | Ramp bill event that caused this trigger. |
| Event time | string | Ramp event creation time, when supplied.  |

## Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/ramp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
