Coupa authentication

Prerequisites

To create a connection, you need the following credentials:

• Bring your own OAuth 2.0 app: Site URL, Client ID, Secret, Scope
• Custom: Site Url, Api key

Creating an OAuth connection

To obtain the necessary credentials for an OAuth connection, log in to Coupa as an integrations-enabled administrator to create a client using a Client credentials grant type.

1. Log in to your Coupa instance and click the Setup button in the upper-right corner of the interface.
2. Scroll to the Integrations section and select Oauth2/OpenID Connect Clients.
3. Click Create.

Add the Coupa connection

1. Select Integration Service from Automation Suite.

2. From the Connectors list, select Coupa. You can also use the search bar to find the connector.
3. Select your preferred authentication type, then select the Connect to Coupa button.
4. Enter the required credentials and select Connect.
5. Your connection has been added.

Scopes

The following Scopes are required for any connection and are automatically selected: email login offline_access openid profile core.common.read.

Depending on your needs, you can select other scopes from the available multiple-selection list. The table below lists all the scopes you may need when interacting with Coupa objects.

Object	Operation	Scopes
accounts	GET /accounts POST/accounts GET/accounts PUT/accounts	core.accounting.read core.accounting.write
approvals	GET/approvals GET/approvals/{id}	core.approval.read
budget_lines	GET /budget_lines GET /budget_lines/{id}	core.budget.read
cancel_purchaseorders	PUT/close_purchaseorders/{id}	core.purchase_order.write
close_purchaseorders	PUT/close_purchaseorders/{id}	core.purchase_order.write
contracts	GET/contracts/{contractId}/attachments GET/contracts/{contractId}/attachments/{attachmentId}	core.contract.read
contracts/{contractId}/retrieve_legal_agreement	GET/contracts/{contractId}/retrieve_legal_agreement	core.contract.read
expense_lines	GET/expense_lines GET/expense_lines/{id}	core.expense.read
expense_reports	GET/expense_reports GET/expense_reports/{id}	core.expense.read
inventory_transactions	GET/inventory_transactions POST/inventory_transactions GET/inventory_transactions/{id}	core.inventory.adjustment.read core.inventory.adjustment.write core.inventory.asn.read core.inventory.balance.read core.inventory.common.read core.inventory.consumption.read core.inventory.consumption.write core.inventory.receiving.read core.inventory.receiving.write core.inventory.transfer.read core.inventory.transfer.write
invoices	GET/invoices POST/invoices GET/invoices/{id} PATCH/invoices/{id}	core.invoice.approval.bypass core.invoice.approval.write core.invoice.create core.invoice.delete core.invoice.read core.invoice.write
issue_purchaseorders	PUT/issue_purchaseorders/{id}	core.purchase_order.write
items	GET/items, POST/items GET/items/{id} PATCH/items/{id}
purchase_order_changes	GET/purchase_order_changes GET/purchase_order_changes/{id}	core.purchase_order.read
purchase_order_lines	GET/purchase_order_lines GET/purchase_order_lines/{id}	core.purchase_order.read
purchase_orders	GET/purchase_orders GET/purchase_orders/{id} PATCH/purchase_orders/{id}	core.purchase_order.read core.purchase_order.write
quote_requests	GET/quote_requests POST/quote_requests GET/quote_requests/{id} PUT/quote_requests/{id}
requisitions	GET/requisitions POST/requisitions GET/requisitions/{id} PATCH/requisitions/{id}	core.requisition.read core.requisition.write
suppliers	GET/suppliers POST/suppliers GET/suppliers/{id} PUT/suppliers/{id}	core.supplier.read core.supplier.write
user_groups	GET /user_groups POST /user_groups GET /user_groups/{id} PATCH / user_groups/{id}	core.user_group.read core.user_group.write
users	GET /users POST /users GET /users/{id} PUT / users/{id}	core.user.read core.user.write