> For the complete documentation index, see [llms.txt](https://docs.acho.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acho.io/acho-studio/resources/import-data/square.md).

# 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](/master.md#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="/files/-MgBo4LSmdK4OS-NqLZy" 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;

![](/files/-Mg2WfOK88UquvAsFyle)

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.

![](/files/-Mg2VhfHwbEVam7wVqRR)

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