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

# Coupa

> Connect BonData to Coupa for spend management and procurement data

Coupa is a business spend management platform covering procurement, invoicing, expenses, and supplier management. With BonData, you can connect to your Coupa account to read, enrich, and sync your spend management data within Agent workflows.

## Coupa OAuth Setup

BonData connects to Coupa using OAuth 2.0 client credentials against the Core API.

### Step 1: Find Your Instance URL

Your Coupa instance URL is the address you use to log in, in the format:

* `https://yourcompany.coupahost.com`

### Step 2: Create an OAuth Client

1. Log in to Coupa as an administrator
2. Go to **Setup** → **Integrations** → **OAuth2/OIDC Clients**
3. Click **Create**
4. Select **Grant Type: Client Credentials**
5. Choose the **Scopes** for the objects you want to sync (for example `core.supplier.read`, `core.purchase_order.read`, `core.invoice.read`)
6. Click **Save**
7. **Copy the Client ID (Identifier) and Client Secret** - the secret is only shown once

<Tip>
  Some older Coupa tenants use a static API Key instead of OAuth. If your admin provides an API Key from **Setup** → **Integrations** → **API Keys**, you can use it in place of the OAuth client.
</Tip>

### Step 3: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **Coupa**
2. Enter your **Instance URL**, **Client ID**, and **Client Secret**
3. Click **Connect**

## Required Fields

<Tabs>
  <Tab title="OAuth 2.0">
    | Field         | Description                                   |
    | ------------- | --------------------------------------------- |
    | Instance URL  | Your Coupa instance URL                       |
    | Client ID     | Client identifier from the OAuth2/OIDC client |
    | Client Secret | Client secret from the OAuth2/OIDC client     |
  </Tab>

  <Tab title="API Key (Legacy)">
    | Field        | Description                                          |
    | ------------ | ---------------------------------------------------- |
    | Instance URL | Your Coupa instance URL                              |
    | API Key      | API Key generated in Setup → Integrations → API Keys |
  </Tab>
</Tabs>

## Available Data

Once connected, BonData can sync the following Coupa objects:

* **Suppliers** - Supplier master records and contacts
* **Purchase Orders** - Purchase orders and their lines
* **Invoices** - Supplier invoices and approval status
* **Requisitions** - Purchase requisitions
* **Expenses** - Expense reports and lines
* **Contracts** - Supplier contracts and terms
