Skip to content
One platform. From customer conversation to completed work.Take a closer look
All connections
Billing & Payments · CONNECTION

Square + NodeHub

View Square payments and customers.

Explore 10 workflow actions for Square, including account permissions and operation limits.

8 read actions2 write actions
WORKFLOW ACTIONS

What you can configure.

Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.

Create customer

Write

Create a customer profile with at least one name, company, email or phone field.

Permissions and limits

Account permissions

  • CUSTOMERS_WRITE

Operation limits

  • Creates profile data only. No card storage, payment or marketing subscription is performed.

A repeated request may repeat the external action. Review the previous result before retrying a write.

Get catalog object

Read

Read one catalog object, including its embedded item details.

Permissions and limits

Account permissions

  • ITEMS_READ

Operation limits

  • Referenced related objects are not expanded. Read their IDs individually if needed.

Get customer

Read

Read a single customer profile and its version.

Permissions and limits

Account permissions

  • CUSTOMERS_READ

Get location

Read

Read a location or use main to read the merchant main location.

Permissions and limits

Account permissions

  • MERCHANT_PROFILE_READ

Get order

Read

Read an order, totals, fulfillment and version without changing it.

Permissions and limits

Account permissions

  • ORDERS_READ

List catalog objects

Read

Read catalog records for explicitly selected object types.

Permissions and limits

Account permissions

  • ITEMS_READ

Operation limits

  • One provider page per execution. Reuse the returned cursor with the original query for subsequent pages; an absent list means no matching records.
  • Square fixes the page size at 100. Deleted catalog objects are excluded.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

List customers

Read

Read a page of customer profiles that contain public contact information.

Permissions and limits

Account permissions

  • CUSTOMERS_READ

Operation limits

  • One provider page per execution. Reuse the returned cursor with the original query for subsequent pages; an absent list means no matching records.
  • New and updated profiles can take a minute or more to appear. Page size is advisory.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

List locations

Read

Read all merchant locations, including inactive locations.

Permissions and limits

Account permissions

  • MERCHANT_PROFILE_READ

Search orders

Read

Read orders from up to ten merchant locations, with optional state filtering and created-date sorting.

Permissions and limits

Account permissions

  • ORDERS_READ

Operation limits

  • One provider page per execution. Reuse the returned cursor with the original query for subsequent pages; an absent list means no matching records.
  • NodeHub limits each page to 100 orders. Offline point-of-sale orders can appear up to 72 hours later. No order changes or payments are performed.

Pagination: cursor. Check the result for additional pages; a single action may not return every record.

Update customer

Write

Update supplied customer profile fields with a required version check to prevent overwriting newer changes.

Permissions and limits

Account permissions

  • CUSTOMERS_WRITE

Operation limits

  • Only supplied nonempty fields are updated. Clearing fields with null and merged-customer resolution are not exposed.

A repeated request may repeat the external action. Review the previous result before retrying a write.

SETUP

Start with a controlled test.

01Connect the intended account

Use the account and permissions required for your process. Review the connection check before configuring a workflow action.

02Review inputs and access

Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.

03Confirm the result

Inspect step outputs and confirm the result in Square. A saved workflow is not a completed provider action.

Follow the workflow quickstart
EXPLORE YOUR STACK

More in Billing & Payments.

Square integration | NodeHub