> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chamelio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ramp

> Add a Chamelio step to Ramp procurement workflows, so purchases that need a contract go to legal in Chamelio and the signed contract comes back to Ramp.

On request

Ramp is turned on per organization. Ask your Chamelio legal engineer to turn it on.

Ramp connects your spend approvals to legal. When a purchase request in Ramp needs a contract or a legal review, a Chamelio step in the Ramp procurement workflow starts a Chamelio flow with the request's details. Legal reviews, negotiates and approves in Chamelio. Ramp shows where legal is, continues when legal is done, and keeps the signed contract with the vendor.

## How it works

1. A requester submits a purchase request in Ramp.
2. The request reaches the **Chamelio** step in your Ramp procurement workflow. Chamelio starts the flow you chose, with the Ramp form answers in its intake fields and the request's files, such as the vendor's paper, attached.
3. Legal works the task in Chamelio, as in any other [flow](https://docs.chamelio.ai/guides/how-flows-and-tasks-work.md). The Ramp request shows the task's status and links to it.
4. When the task completes, the Chamelio step in Ramp is approved and the workflow continues. If legal rejects, the step is rejected with legal's reason.
5. The signed contract and its key dates go back to Ramp, on the request and the vendor.

## Before you start

* Ramp turned on for your organization by your Chamelio legal engineer
* A Chamelio account with Admin permission
* A Ramp admin who can manage integrations and procurement workflows

## Step 1: Connect Ramp and Chamelio

**1. Find Chamelio in Ramp**

In Ramp, go to **Settings** > **Integrations** and open **Chamelio**.

**2. Connect**

Click **Connect**. Sign in to Chamelio with an Admin account and approve the access Ramp asks for.

**3. Check the connection**

In Chamelio, go to **Settings** > **Org Integrations**. The **Ramp** card shows Ramp as connected.

Connect with a shared company account on both sides, not a person's own account, so the connection keeps working when people leave. See [Use a shared IT account](https://docs.chamelio.ai/guides/integrations/summary.md#use-a-shared-it-account-for-organization-connections).

## Step 2: Build the Ramp flow in Chamelio

**1. Start the flow from Ramp**

Open the flow in the flow builder. In the **Intake** step, select **Ramp** under **Start from...**.

**2. Map the Ramp fields**

Open each intake field and choose the Ramp field that fills it, for example the vendor, amount, category or a custom form answer.

**3. Build and publish**

Add the review, approval and signature steps legal needs, then publish the flow.

## Step 3: Add the Chamelio step in Ramp

**1. Open the procurement workflow**

In Ramp, open the procurement workflow in the **Workflow Builder**.

**2. Add the step**

Click **+** where legal review belongs, for example after a **Split paths** step for new vendors or purchases above a threshold. Under **Integrations**, choose **Chamelio**.

**3. Choose the flow**

Choose the Chamelio flow from Step 2. Turn on waiting for Chamelio if the request should pause until legal is done.

**4. Save and publish**

Click **Save**, then publish the workflow from the program editor. New requests use the Chamelio step. Requests already in progress keep the workflow version they started with.

To use the same legal review in several spend programs, set the split paths once and add the Chamelio step after them in each program's workflow.

## What moves between Ramp and Chamelio

| From Ramp to Chamelio | From Chamelio to Ramp |
| - | - |
| The purchase request's form answers, vendor, amount and category | The task's status and a link to it, on the request |
| The requester | Legal's decision on the Chamelio step: approved or rejected, with the reason |
| The request's files, such as the vendor's paper | The signed contract on the request and the vendor |
| | The contract's start date, end date and renewal date |

## Test the connection

Submit a test purchase request in Ramp that reaches the Chamelio step. Check that a task for your Ramp flow appears in Chamelio with the intake fields filled, then complete it and check that the Ramp request moves on with the signed contract attached.

## Common questions

> [accordion] Can I connect Ramp without the Chamelio step?
>
> Yes. Ramp's **Custom API workflow** step sends a webhook when a request reaches it, and your systems approve or reject the step through the Ramp API. Your developers can call [Initiate Workflow](https://docs.chamelio.ai/api-reference/endpoint/workflows/initiate.md) from that webhook and use [Chamelio webhooks](https://docs.chamelio.ai/api-reference/webhooks/introduction.md) to answer Ramp. Ramp turns on the Custom API workflow step for your account through Ramp Support.

> [accordion] How do I disconnect Ramp?
>
> In Ramp, go to **Settings** > **Integrations**, open **Chamelio** and disconnect it. Remove the Chamelio step from your procurement workflows first, so requests don't wait on a step that can't run.
