Skip to main content
An integrations-enabled Coupa administrator is required to create an OAuth2/OpenID Connect client.

​
Find your instance subdomain

Your Coupa instance subdomain is the first part of the address you sign in to.

  • Format: https://{instance}.coupahost.com
  • Example: if you sign in at https://acme.coupahost.com, your Instance Subdomain is acme.

​
Create an OAuth2/OpenID Connect client

Create a Client Credentials OAuth2/OpenID Connect client in Coupa to obtain a Client ID and Client Secret.

1

Open OAuth2/OpenID Connect Clients

Sign in to your Coupa instance as an integrations-enabled administrator and navigate to Setup > Integrations > OAuth2/OpenID Connect Clients.

2

Create the client

Click Create and configure the client.

  • For Grant Type, select Client Credentials.
  • Enter a Name, Login, Contact Info, and Contact Email.
3

Select the required scopes

Under Scopes, select the permissions your integration needs. Scopes follow the pattern core.<object>.read / core.<object>.write (singular object name). Grant read scopes for resources you will read, and write scopes for those you will create or update. The full list for your instance is at https://{instance}.coupahost.com/oauth2/scopes.

​
Copy your credentials

After saving the client, copy the credentials needed to connect.

1

Copy the Client ID and Client Secret

From the client you just created, copy the Client ID and Client Secret.

  • The Client Secret is shown only once — store it securely for use later.
2

Note the scopes you granted

In StackOne, the Scopes field takes a space-separated list of the scopes you selected on the client (for example core.invoice.read core.supplier.read core.purchase_order.read). It must be a subset of the scopes granted to the client.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Instance Subdomain
  • Client ID
  • Client Secret
  • Scopes
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.