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

# Awardco Connector

## Intro

Awardco is a cloud-based employee recognition solution designed to boost employee engagement and simplify the reward process with incentivized programs. With Awardco, managers can recognize and reward the deserving employee within a matter of seconds, making the recognition process more empowering, relaxing, and flavorful from service awards to sales incentives. Use Domo's Awardco connector to retrieve data about recognitions, redemptions, transactions, and users in your organization. To learn more about the Awardco API, visit their page ([https://api.awardco.com/](https://api.awardco.com/ "https://api.awardco.com/") ).

You connect to your Awardco account in the Data Center. This topic discusses the fields and menus that are specific to the Awardco 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 "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your Awardco account and create a DataSet, you must have your Awardco API key.

#### Obtaining the API key:

1. Log in to your Award Force account.
2. Go to
   **Settings > General > Integration**.
3. Note your Account ID (It will be required for validating your access tokens).
4. Next to the
   **API key** field, click **Generate key**.
5. You will see the API key field populated with your new key. Copy this key and paste it in the Connector's Credentials section (API Key). You can generate a new key at any time. Once a new key is generated, the old key will stop working.

<Note>
  **Note:** In order to generate the API key, you must have the "Awards manager" account privileges.
</Note>

## Connecting to Your Awardco Account

This section enumerates the options in the **Credentials** and **Details** panes in the Awardco 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 Awardco 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"> API Key </td><td colspan="1" rowspan="1"> Enter your Awardco API key. See "Prerequisites" for more details. </td></tr></tbody></table>

Once you have entered valid Awardco credentials, you can use the same account any time you go to create a new Awardco 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 <span class="s1"> Awardco </span> 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"> Recognition Detail </td><td colspan="1" rowspan="1"> Returns a detail level report for recognition within the selected time frame. </td></tr><tr><td colspan="1" rowspan="1"> Recognition Summary </td><td colspan="1" rowspan="1"> Returns a summary level report for recognition within the selected time frame. </td></tr><tr><td colspan="1" rowspan="1"> Redemption Detail </td><td colspan="1" rowspan="1"> Returns a detail level report for redemption within the selected time frame. </td></tr><tr><td colspan="1" rowspan="1"> Redemption Fifo </td><td colspan="1" rowspan="1"> Returns the information for redemption fifo report within the selected time frame </td></tr><tr><td colspan="1" rowspan="1"> Redemption Summary </td><td colspan="1" rowspan="1"> Returns a summary level report for redemption within the selected time frame. </td></tr><tr><td colspan="1" rowspan="1"> Transactions </td><td colspan="1" rowspan="1"> Returns all transactions within the selected time frame. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Returns a list of all users. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Date Selection </td><td colspan="1" rowspan="1"> Select the date format for your data. </td></tr><tr><td colspan="1" rowspan="1"> Single Date </td><td colspan="1" rowspan="1"> Select whether the report data is for a specific date or for a relative number of days back from today. </td></tr><tr><td colspan="1" rowspan="1"> Specific Date </td><td colspan="1" rowspan="1"> Select the specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Relative Date </td><td colspan="1" rowspan="1"> Enter the number of days back that you would like to get data for in the <b><b> Days Back </b></b> field. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Date Range </td><td colspan="1" rowspan="1"> Select the specific or relative date range. </td></tr><tr><td colspan="1" rowspan="1"> Start Date - Specific </td><td colspan="1" rowspan="1"> Select the first date in your date range using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> End Date - Specific </td><td colspan="1" rowspan="1"> Select the last date in your date range using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Start Date - Relative </td><td colspan="1" rowspan="1"><p> Enter the number of days back that you would like to get data from (start day). Combine with <b><b><b><b><b><b><b><b> End Date </b></b></b></b></b></b></b></b> to create a range of represented days. </p><p> For example, if you entered 10 for <b><b><b><b><b><b><b><b> Start Date </b></b></b></b></b></b></b></b> and 5 for <b><b><b><b><b><b><b><b> End Date </b></b></b></b></b></b></b></b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"> End Date - Relative </td><td colspan="1" rowspan="1"><p> Enter the number of days back that you would like to get data to (end day). Combine with <b><b><b><b><b><b><b><b> Start Date </b></b></b></b></b></b></b></b> to create a range of represented days. </p><p> For example, if you entered 10 for <b><b><b><b><b><b><b><b> Start Date </b></b></b></b></b></b></b></b> and 5 for <b><b><b><b><b><b><b><b> End Date </b></b></b></b></b></b></b></b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"> Time Period </td><td colspan="1" rowspan="1"> Choose the time period that you would like to receive data for. </td></tr><tr><td colspan="1" rowspan="1"> Starting Day of the Week </td><td colspan="1" rowspan="1"> Select the day you would like your week to start with. </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").
