> ## 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.

# Workiva Connector

## Intro

Workiva is a leading cloud platform for connected reporting across accounting, finance, audit, and internal controls. To learn more about the Workiva API, visit their page ([https://success.workiva.com/developers/api-reference](https://success.workiva.com/developers/api-reference)).

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

## Prerequisites

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

* A Workiva client ID
* A Workiva client secret

To learn how to obtain credentials, see [https://success.workiva.com/developers/guides/setup](https://success.workiva.com/developers/guides/setup).

## Connecting to Your Workiva Account

This section enumerates the options in the **Credentials** and **Details** panes in the Workiva 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 Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Workiva 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> Client ID </p></td><td colspan="1" rowspan="1"><p> Enter your Workiva client ID. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Client Secret </p></td><td colspan="1" rowspan="1"><p> Enter your Workiva client secret. </p></td></tr></tbody></table>

Once you have entered valid Workiva credentials, you can use the same account any time you go to create a new Workiva 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 for configuring your report.

<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 Workiva report you want to run. Currently only a single report type is available. </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Spreadsheets </p></td><td colspan="1" rowspan="1"><p> Returns data from a specified spreadsheet and region. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Spreadsheet ID </p></td><td colspan="1" rowspan="1"><p> Enter the ID of your Workiva spreadsheet. This can be found in the spreadsheet URL. For example, in the URL <span class="nowiki"><a href="https://app" rel="noopener" target="_blank"> [https://app](https://app) </a>. <a href="http://wdesk.com/a/aabbccddeeffgghhkkllXTest/spreadsheet/aaaa-bbbb-cccc-dddd-eeee" rel="noopener" target="_blank"> wdesk.com/a/aabbccddeeffgghhkkllXTest/spreadsheet/aaaa-bbbb-cccc-dddd-eeee </a></span>, the ID is <span class="mt-font-courier-new"> aaaa-bbbb-cccc-dddd-eeee </span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheet ID </p></td><td colspan="1" rowspan="1"><p> Select the specific sheet you want to retrieve data from. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Region </p></td><td colspan="1" rowspan="1"><p> Enter the region of the spreadsheet you want to pull into Domo. Formatting guidelines are as follows: </p><table class="mt-responsive-table"><thead><tr><th colspan="1" rowspan="1"><p> If you were to enter this... </p></th><th colspan="1" rowspan="1"><p>...the following data would be pulled into Domo </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> A1 </span></p></td><td colspan="1" rowspan="1"><p> Data from the cell A1 </p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> A2:D8 </span></p></td><td colspan="1" rowspan="1"><p> All data in the range between A2 and D8 (inclusive) </p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> A:A </span></p></td><td colspan="1" rowspan="1"><p> All data in column A </p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> 1:3 </span></p></td><td colspan="1" rowspan="1"><p> All data in rows 1 through 3 </p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new"> B3: </span></p></td><td colspan="1" rowspan="1"><p> All data below and to the right of B3 (inclusive) </p></td></tr><tr><td colspan="1" rowspan="1"><p><span class="mt-font-courier-new">: </span></p></td><td colspan="1" rowspan="1"><p> All data in the sheet </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Value Style </p></td><td colspan="1" rowspan="1"><p> Select whether you want cell values to be returned as raw or calculated. If you select <b> Raw </b>, <b /> raw values are returned (such as <span class="mt-font-courier-new"> 1 + 1 </span> instead of <span class="mt-font-courier-new"> 2 </span> ). If you select <b> Calculated </b>, values are calculated before being pulled into Domo. </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).

## FAQs

<AccordionGroup>
  <Accordion title="What endpoint is the base URL for this connector?">
    [https://api.app.wdesk.com](https://api.app.wdesk.com "https://api.app.wdesk.com")
  </Accordion>

  <Accordion title="How frequently will my data update?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    No.
  </Accordion>

  <Accordion title="Can I use the same account to create multiple DataSets?">
    Yes.
  </Accordion>
</AccordionGroup>
