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.