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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acho.io/acho-studio/resources/import-data/square.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
