Skip to main content

Coupa

Connect Coupa to BotDojo so your agents can look up procurement records through Coupa's native Core API.

Before You Start​

You need access to a Coupa instance and an OAuth2 / OpenID Connect client created in Coupa with the Client Credentials grant type.

Ask your Coupa admin for:

  • Instance URL, for example https://example.coupahost.com
  • OAuth client ID
  • OAuth client secret
  • Space-separated Coupa scopes, for example core.invoice.read core.purchase_order.read core.supplier.read

Connect Coupa In BotDojo​

  1. In Coupa, create or open an OAuth2 / OpenID Connect client for API access.
  2. Enable the Client Credentials grant type.
  3. Grant the Coupa scopes for the objects your agent should inspect.
  4. In BotDojo, open Integrations.
  5. In Agent Tools, find Coupa and click Connect.
  6. Enter the instance URL, OAuth client ID, OAuth client secret, and scopes.
  7. Click Test Connection to verify token acquisition.
  8. Click Connect.

What This Integration Supports​

Supported tools:

  • list invoices
  • get invoice
  • list purchase orders
  • get purchase order
  • list suppliers
  • get supplier

List tools support a bounded limit, offset, date filters, selected convenience filters, and a raw query object for exact Coupa query parameters such as updated_at[gt_or_eq], supplier[id], or name[contains].

Notes​

  • BotDojo exchanges the OAuth client credentials for an access token and caches it until shortly before expiry.
  • The connection test only validates OAuth token acquisition. Run a Coupa tool after connecting to verify that the selected scopes can access the expected Coupa records.
  • Coupa API keys are deprecated for Core API integrations; use OAuth2 / OpenID Connect clients instead.
  • This is a native Coupa Core API integration, not a Composio, Workato, IBM App Connect, CData, or MCP wrapper.

References​