ContextQMD
Back to Airbyte

Square

docs/integrations/sources/square.md

2.0.012.3 KB
Original Source

Square

This page contains the setup guide and reference information for the Square source connector.

Prerequisites

To set up the Square source connector with Airbyte, you'll need to create your Square Application and use Personal token or Oauth access token.

Setup guide

Step 1: Set up Square

  1. Create Square Application
  2. Obtain Personal token or Oauth access token.

Step 2: Set up the Square connector in Airbyte

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.
  3. On the Set up the source page, enter the name for the Square connector and select Square from the Source type dropdown.
  4. Choose authentication method:
    • Api-Key
      • Fill in API key token with "Access token" from Square Application settings page (Credentials on the left)
    • Oauth authentication
      • Fill in Client ID and Client secret with data from Square Application settings page (Oauth on the left)
      • Fill in refresh token with one obtained during the authentication process
  5. Choose if your account is sandbox
  6. Choose start date
  7. Choose if you would like to include Deleted objects (for streams: Items, Categories, Discounts, Taxes)

For Airbyte OSS:

  1. Navigate to the Airbyte Open Source dashboard.
  2. Set the name for your source.
  3. On the Set up the source page, enter the name for the Square connector and select Square from the Source type dropdown.
  4. Choose authentication method:
    • Api-Key
      • Fill in API key token with "Access token" from Square Application settings page (Credentials on the left)
    • Oauth authentication
      • Fill in Client ID and Client secret with data from Square Application settings page (Oauth on the left)
      • Fill in refresh token with one obtained during the authentication process
  5. Choose if your account is sandbox
  6. Choose start date
  7. Choose if you would like to include Deleted objects (for streams: Items, Categories, Discounts, Taxes)

Supported sync modes

The Square source connector supports the following sync modes:

Supported Streams

Connector-specific features & highlights

Useful links:

Performance considerations (if any)

No defined API rate limits were found in Square documentation however considering this information it has 10 QPS limits. The connector doesn't handle rate limits exceptions, but no errors were raised during testing. Exponential Backoff strategy recommended.

Data type map

Integration TypeAirbyte TypeNotes
stringstring
integerinteger
arrayarray
objectobject
booleanboolean

Changelog

<details> <summary>Expand to review</summary>
VersionDatePull RequestSubject
1.7.132026-03-1775101Update dependencies
1.7.122026-03-1074570Update dependencies
1.7.112026-02-1772374Update dependencies
1.7.102025-11-2570017Update dependencies
1.7.92025-11-1869524Update dependencies
1.7.82025-11-0469161Update dependencies
1.7.72025-08-2465422Update dependencies
1.7.62025-07-2063672Update dependencies
1.7.52025-06-2862212Update dependencies
1.7.42025-06-1449109Update dependencies
1.7.32025-03-2553695fix object_types string to array
1.7.32025-02-1553695Fix parameter of categories, discounts, items, modifier_list taxes
1.7.22024-10-2947869Update dependencies
1.7.12024-10-2847608Update dependencies
1.7.02024-10-0646527Migrate to Manifest-only
1.6.232024-10-0546409Update dependencies
1.6.222024-09-2846162Update dependencies
1.6.212024-09-2145787Update dependencies
1.6.202024-09-1445550Update dependencies
1.6.192024-09-0745045Update dependencies
1.6.182024-08-2444745Update dependencies
1.6.172024-08-1744325Update dependencies
1.6.162024-08-1243915Update dependencies
1.6.152024-08-1043498Update dependencies
1.6.142024-08-0343110Update dependencies
1.6.132024-07-2742638Update dependencies
1.6.122024-07-2042226Update dependencies
1.6.112024-07-1341913Update dependencies
1.6.102024-07-1041502Update dependencies
1.6.92024-07-0941124Update dependencies
1.6.82024-07-0640989Update dependencies
1.6.72024-06-2540313Update dependencies
1.6.62024-06-2240027Update dependencies
1.6.52024-06-0639206[autopull] Upgrade base image to v1.2.2
1.6.42024-06-1230315Fix customer stream pagination limit
1.6.32024-06-1439377Add error handlers, migrate to inline schemas, move spec to manifest
1.6.22024-05-0337800Migrate to Poetry. Replace custom components with default classes
1.6.12023-11-0731481Fix duplicate records for Payments and Refunds stream
1.6.02023-10-1831115Add customer_id field to Payments and Orders streams
1.5.02023-10-1631045Added New Stream bank_accounts
1.4.02023-10-1331106Add new stream Loyalty
1.3.02023-10-1231107Add new stream Inventory
1.2.02023-10-1031065Add new stream Cash drawers shifts
1.1.32023-10-1030960Update airbyte-cdk version to >=0.51.31
1.1.22023-07-1028019fix display order of spec fields
1.1.12023-06-2827762Update following state breaking changes
1.1.02023-05-2426485Remove deprecated authSpecification in favour of advancedAuth
1.0.12023-05-0325784Fix Authenticator
1.0.02023-05-0325784Fix Authenticator
0.2.22023-03-2222867Specified date formatting in specification
0.2.12023-03-0623231Publish using low-code CDK Beta version
0.2.02022-11-1419369Migrate to low code (YAML); update API to version 2022-10-19; update docs
0.1.42021-12-026842Added oauth support
0.1.32021-12-068425Update title, description fields in spec
0.1.22021-11-087499Remove base-python dependencies
0.1.12021-07-094645Update _send_request method due to Airbyte CDK changes
0.1.02021-06-304439Initial release supporting the Square API
</details>