> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Square connector

- Connector: `appmixer.square`
- Version: 1.1.3
- Components: 7 (0 triggers, 7 actions)

Square connector for Appmixer that provides customer management and business location services integration with Square's platform.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.square/1.1.3>
- Documentation: <https://docs.appmixer.com/connector-configuration/square>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/square>
- Download package: <https://connectors.appmixer.com/connector/appmixer.square/1.1.3/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Scopes:**

- `MERCHANT_PROFILE_READ`
- `CUSTOMERS_READ`
- `CUSTOMERS_WRITE`
- `ORDERS_READ`
- `ORDERS_WRITE`
- `ITEMS_READ`
- `INVENTORY_READ`

## Actions (7)

- [Delete Customer](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.DeleteCustomer.md) (`appmixer.square.core.DeleteCustomer`): Delete a customer profile from a business.
- [Find Customers](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.FindCustomers.md) (`appmixer.square.core.FindCustomers`): Search and retrieve customer profiles.
- [Create Customer](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.CreateCustomer.md) (`appmixer.square.core.CreateCustomer`): Create a new customer profile.
- [Get Customer](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.GetCustomer.md) (`appmixer.square.core.GetCustomer`): Retrieve detailed information for a specific customer by their Id.
- [List Customer Groups](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.ListCustomerGroups.md) (`appmixer.square.core.ListCustomerGroups`): List Customer Groups.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.MakeApiCall.md) (`appmixer.square.core.MakeApiCall`): Performs an arbitrary authorized API call to the Square API.
- [Update Customer](https://connectors.appmixer.com/connector/appmixer.square/1.1.3/component/appmixer.square.core.UpdateCustomer.md) (`appmixer.square.core.UpdateCustomer`): Update the profile information of an existing customer.

## Changelog

### 1.1.3

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.1.2

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.1.1

- Fixed a crash when a Find/List component saved an EMPTY result set to a CSV file — the header row was built from the first record without checking there was one, so a search that legitimately matched nothing failed the flow instead of writing an empty file.

### 1.1.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the Square API.

### 1.0.2

- Added output examples to component schemas.

### 1.0.1

- Initial version
