> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Coupa OAuth Connector

## Intro

Coupa OAuth Connector is a cloud-based spend management platform that unifies business processes across your entire organization. To learn more about the Coupa API, visit their page ([https://coupadocs.atlassian.net/wiki...4478/Coupa+API](https://coupadocs.atlassian.net/wiki/spaces/integrate/pages/524478/Coupa+API "https://coupadocs.atlassian.net/wiki/spaces/integrate/pages/524478/Coupa+API") ).

You connect to your Coupa account in the Data Center. This topic discusses the fields and menus that are specific to the Coupa connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

## Prerequisites

To connect to your Coupa account and create a DataSet, you must have the following:

* A Coupa API key. You can create an API key within the
  **API Keys** section of the **Adminstration** tab in Coupa. You must be an admin user to be able to do this.
* Your Coupa instance. This is the portion of your Coupa URL immediately following
  https\://. For example if your instance URL was [https://domo.coupahost.com](https://domo.coupahost.com/ "https://domo.coupahost.com"), you would enter domo as your instance.

## Connecting to Your Coupa Account

This section enumerates the options in the **Credentials** and **Details** panes in the Coupa Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Coupa account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><span> INSTANCE </span></p></td><td colspan="1" rowspan="1"><p> Enter your Coupa instance. This instance is the subdomain of your hostname. </p></td></tr><tr><td colspan="1" rowspan="1"><p> CLIENT ID </p></td><td colspan="1" rowspan="1"><p> Enter the Client ID from your Coupa application. </p></td></tr><tr><td colspan="1" rowspan="1"><p> CLIENT SECRET </p></td><td colspan="1" rowspan="1"><p> Enter the Client Secret from your Coupa application. </p></td></tr><tr><td colspan="1" rowspan="1"><p> SCOPES </p></td><td colspan="1" rowspan="1"><p> Enter the list of SCOPES separated by spaces. </p></td></tr></tbody></table>

For more information about obtaining these credentials, see "Prerequisites," above.

Once you have entered valid Coupa credentials, you can use the same account any time you go to create a new Coupa DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Coupa report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><b> Report Name </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Invoices </td><td colspan="1" rowspan="1"> Returns Coupa invoices. </td></tr><tr><td colspan="1" rowspan="1"> Invoice Lines </td><td colspan="1" rowspan="1"> Returns invoice lines for each applicable Coupa invoice. Relates to Invoices by invoice id. </td></tr><tr><td colspan="1" rowspan="1"> Invoice Payments </td><td colspan="1" rowspan="1"> Returns invoice payments for each applicable Coupa invoice. Relates to Invoices by invoice id. </td></tr><tr><td colspan="1" rowspan="1"> Invoice Tax Lines </td><td colspan="1" rowspan="1"> Returns invoice tax lines for each applicable Coupa invoice. Relates to Invoices by invoice id. </td></tr><tr><td colspan="1" rowspan="1"> Invoice Approvals </td><td colspan="1" rowspan="1"> Returns invoice approvals for each applicable Coupa invoice. Relates to Invoices by invoice id. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Order Changes </td><td colspan="1" rowspan="1"> Returns purchase orders with change orders. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Order Changes Approvals </td><td colspan="1" rowspan="1"> Returns approvals for purchase orders with change orders. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Order Changes Order Lines </td><td colspan="1" rowspan="1"> Returns order lines for purchase orders with change orders. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Orders </td><td colspan="1" rowspan="1"> Returns Coupa purchase orders. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Order Lines </td><td colspan="1" rowspan="1"> Returns order lines for each applicable purchase order. Relates to Purchase Orders by purchase order id. </td></tr><tr><td colspan="1" rowspan="1"> Purchase Order Lines (Latest) </td><td colspan="1" rowspan="1"> Returns Coupa purchase order lines. Relates to Purchase Orders by order header id. </td></tr><tr><td colspan="1" rowspan="1"> Requisitions </td><td colspan="1" rowspan="1"> Returns Coupa requisitions. </td></tr><tr><td colspan="1" rowspan="1"> Requisition Approvals </td><td colspan="1" rowspan="1"> Returns Coupa requisition approvals. </td></tr><tr><td colspan="1" rowspan="1"> Requisition Lines </td><td colspan="1" rowspan="1"> Returns requisition lines for each applicable requisition. Relates to Requisitions by requisition id. </td></tr><tr><td colspan="1" rowspan="1"> Accounts </td><td colspan="1" rowspan="1"> Returns a list of Coupa accounts. </td></tr><tr><td colspan="1" rowspan="1"> Addresses </td><td colspan="1" rowspan="1"> Returns a list of Coupa addresses. </td></tr><tr><td colspan="1" rowspan="1"> Content Groups </td><td colspan="1" rowspan="1"> Returns a list of Coupa content groups. </td></tr><tr><td colspan="1" rowspan="1"> Currencies </td><td colspan="1" rowspan="1"> Returns a list of Coupa currencies. </td></tr><tr><td colspan="1" rowspan="1"> Contracts </td><td colspan="1" rowspan="1"> Returns a list of Coupa contracts. </td></tr><tr><td colspan="1" rowspan="1"> Departments </td><td colspan="1" rowspan="1"> Returns a list of Coupa departments. </td></tr><tr><td colspan="1" rowspan="1"> Exchange Rates </td><td colspan="1" rowspan="1"> Returns a list of Exchange Rates. </td></tr><tr><td colspan="1" rowspan="1"> Expense Reports </td><td colspan="1" rowspan="1"> Returns a list of Expense Rates. </td></tr><tr><td colspan="1" rowspan="1"> Expense Trip Reports </td><td colspan="1" rowspan="1"> Returns a list of Expense Trip Reports. </td></tr><tr><td colspan="1" rowspan="1"> Suppliers </td><td colspan="1" rowspan="1"> Returns a list of Coupa suppliers. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Returns a list of Coupa users. </td></tr><tr><td colspan="1" rowspan="1"><p> User Groups </p></td><td colspan="1" rowspan="1"> Returns a list of Coupa user groups. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> Select whether you want to pull data for a specific date or a date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> Select whether the report data is for a specific date or for a relative number of days back from today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> Select the date for the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> Enter the number of past days that should appear in the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in <b> End Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in <b> Start Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> Select the first date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> Select the second date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> Days Back to End At </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Days Back to Start From </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days to Retrieve </p></td><td colspan="1" rowspan="1"><p> Enter the number of days back to retrieve data for. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## FAQ

<AccordionGroup>
  <Accordion title="How often can the data be updated?">
    DataSets can be updated as often as once per hour.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    Coupa does not document any limits in their API.
  </Accordion>
</AccordionGroup>
