Skip to main content

​
What’s supported

​
Supported actions

This connector supports:

​
Example integration

To define an integration for Coupa, create a manifest file that looks like this: 
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: coupa-integration
    displayName: My Coupa Integration
    provider: coupa
    proxy:
      enabled: true

​
Before you get started

To connect Coupa with Ampersand, you will need a Coupa account. Once your account is ready, you’ll need to create a Coupa OAuth2 app and obtain the following credentials:
  • Client ID
  • Client Secret
  • Scopes
You will also need your Coupa instance domain (the workspace value), which is your Coupa instance URL (e.g., mycompany.coupahost.com).

​
Creating a Coupa app

  1. Log in to your Coupa instance as an administrator.
  2. Navigate to Setup → Oauth2 / OpenID Connect Clients.
  3. Click Create to register a new OAuth2 client.
  4. Fill in the application name and description.
  5. Under Redirect URI, add the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
  6. Select the scopes your integration requires.
  7. Click Save.
  8. Copy the generated Client ID and Client Secret.
For more details, refer to the Coupa API get started guide.

​
Add your Coupa app info to Ampersand

  1. Log in to your Ampersand Dashboard.
  2. Select the project where you want to create a Coupa integration. Ampersand Project Selection
  3. Select Provider apps.
  4. Select Coupa from the Provider list.
  5. Enter the Client ID and Client Secret you copied earlier.
  6. Enter the scopes your integration requires.
  7. Click Save changes.

​
Using the connector

To start integrating with Coupa:
  • Create a manifest file like the example above.
  • Deploy it using the amp CLI.
  • Embed the InstallIntegration UI component. The UI component will prompt the customer for OAuth authorization and their Coupa instance domain.
  • Start using the connector!
    • If your integration has Proxy Actions, you can start making Proxy API calls.
Please note that this connector’s base URL is https://{{.workspace}}, where workspace is your Coupa instance domain (e.g., mycompany.coupahost.com).