# Square

## 1. How to connect to Square?

You can follow the following steps to build a connection with your Square. If you need any helps to set up your integration, please [contact us](https://docs.acho.io/master#how-to-contact-us).

1\. Go to the **Resources** page and click the **Add Resource** button.

2\. In the "Select a data source" step, select **Square** under **Apps**.

3\. In the "Configure the data source" step, enter the following information:

* **`Access Token`**: The value of the API token generated. See [here](#2.-how-to-get-square-api-key) to get an API token.
* **`Include Deleted`:** If yes, deleted objects will be included in the results.&#x20;
* **`Is Sandbox`**: If yes, the access token is for the Sandbox environment. Otherwise, it's for the Production environment.
* **`Start Date (UTC)`**: Retrieve data from a specific date. The date should be defined in UTC date and time, such as 2017-01-25.

4\. In the "Select the tables", choose tables that you want to connect. See [here](#4.-available-tables) for more details on each table.

5\. Click **Finish Setup**. You will see a  <img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_fx7PCUqvFEdrucJC%2F-MgBh5PshcmRFk38itib%2F-MgBo4LSmdK4OS-NqLZy%2Fsyncing.png?alt=media&#x26;token=452494f9-e4be-48fa-9644-bee7d969c46c" alt="" data-size="line"> icon next to your Square resource. It may take a few minutes to several hours depending on the data size and the number of your tables. Once your APP's data is ready, you will receive a notification email.&#x20;

## 2. How to get Square API key?

1\. Open the [Developer Dashboard](https://developer.squareup.com/apps) and select an application. Then, the **Credentials** page for the selected application is shown. (If you didn't create any application before, please create a new one first)&#x20;

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_fx7PCUqvFEdrucJC%2F-Mg2QlKl8nJzjYTDa2qK%2F-Mg2WfOK88UquvAsFyle%2Fimage.png?alt=media\&token=3ae267df-eddb-442b-80b8-238c8a78dfab)

2\. Set the dashboard mode to **Production** for a production access token or to **Sandbox** for a Sandbox access token (used in testing).

3\. Copy the **Access Token** in the **Credentials** section of the page.

![](https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_fx7PCUqvFEdrucJC%2F-Mg2QlKl8nJzjYTDa2qK%2F-Mg2VhfHwbEVam7wVqRR%2Fimage.png?alt=media\&token=cd1ba910-0081-4044-8dc6-34e15db09d48)

## 3. How to set up Data Sync?

Acho supports creating schedulers to retrieve the latest data from Shopify at a certain time interval. To see more details, you can visit [here](https://docs.acho.io/data-sync/untitled).

## 4. Available Tables

* Categories (Incremental)
* Customers&#x20;
* Discounts (Incremental)
* Items (Incremental)
* List Team Member Wages  (old V1 Roles API)&#x20;
* Locations&#x20;
* ModifierLists (Incremental)
* Orders
* Payments (Incremental)
* Refunds (Incremental)
* Shifts&#x20;
* Taxes (Incremental)
* Team Members (old V1 Employees API)&#x20;
