Coupa Tool
Read Coupa procurement data — requisitions, purchase orders, suppliers, and invoices — via the Coupa REST API.
Tool ID
coupa-procurement
Credential Required
Yes — a server-refreshed oauth credential (auth mode: oauth_user). The InTouch server resolves and refreshes the linked OAuth credential and hands the tool a live access token; the tool never refreshes or stores tokens itself. All requests go to https://<instance>.coupahost.com/api with Authorization: Bearer <access_token>.
Credential Properties
| Property | Type | Default | Description |
|---|---|---|---|
client_id |
string | — | OAuth app client ID (the Coupa OAuth2/OIDC client) |
client_secret |
string | — | OAuth app client secret (if required on refresh) |
token_url |
string | — | Provider OAuth token endpoint — used to refresh |
access_token |
string | — | Required. Current access token — kept fresh by the server; do not edit by hand |
refresh_token |
string | — | Refresh token; enables automatic server-side refresh |
token_type |
string | Bearer |
Token type |
scope |
string | — | Granted OAuth scopes (space-separated) |
expires_at |
string | — | Access-token expiry in epoch seconds (0 = non-expiring) |
The Coupa tenant itself is not part of the credential — each task supplies the instance input (the <instance> in https://<instance>.coupahost.com).
Operations
1. list_requisitions — List requisitions
Lists requisitions. Calls GET /requisitions.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string (enum) | — | Required. One of: list_requisitions, list_purchase_orders, get_purchase_order, list_suppliers, list_invoices |
instance |
string | — | Required. Coupa tenant host — the ' |
query |
string | — | Optional query params as a JSON object string, e.g. {"limit": 10, "offset": 0} |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
2. list_purchase_orders — List purchase orders
Lists purchase orders. Calls GET /purchase_orders.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string (enum) | — | Required. |
instance |
string | — | Required. Coupa tenant host |
query |
string | — | Optional query params as a JSON object string, e.g. {"limit": 10, "offset": 0} |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
3. get_purchase_order — Get one purchase order
Fetches a single purchase order by id. Calls GET /purchase_orders/{id}.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string (enum) | — | Required. |
instance |
string | — | Required. Coupa tenant host |
id |
string | — | Required for this operation. Purchase order id |
query |
string | — | Optional query params as a JSON object string |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
4. list_suppliers — List suppliers
Lists suppliers. Calls GET /suppliers.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string (enum) | — | Required. |
instance |
string | — | Required. Coupa tenant host |
query |
string | — | Optional query params as a JSON object string |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
5. list_invoices — List invoices
Lists invoices. Calls GET /invoices.
Properties:
| Property | Type | Default | Description |
|---|---|---|---|
operation |
string (enum) | — | Required. |
instance |
string | — | Required. Coupa tenant host |
query |
string | — | Optional query params as a JSON object string |
Published Outputs:
- result — the JSON response body
- status — HTTP status code
License
This connector requires a per-tool connector license on Department and Enterprise editions (Personal, Solo, and Team editions are unaffected). The license is applied via the tool's Apply License action.
Self-Contained JAR
The jar bundles all runtime dependencies; only intouch-tool-api is provided by the server.
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
completeoperationresultstatuswarning