Actions21
Overview
This node integrates with the Square API to manage customer data. Specifically, the "Customer" resource with the "Get" operation retrieves detailed information about a specific customer by their unique ID. This is useful in scenarios where you need to fetch customer details for further processing, such as personalizing communications, verifying customer identity, or syncing customer data with other systems.
Practical examples include:
- Retrieving a customer's profile before sending a personalized email.
- Fetching customer details to display in a CRM dashboard.
- Validating customer existence before creating an order or booking.
Properties
| Name | Meaning |
|---|---|
| Customer ID | The unique identifier of the customer to retrieve. This is a required string input. |
Output
The output is a JSON object representing the customer data returned from the Square API. It typically includes fields such as customer name, contact information, creation date, and any custom attributes stored in Square.
If the request fails (e.g., invalid ID), the node can return an error message in the output if configured to continue on failure.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Square API.
- The node uses the Square API base URL, which switches between sandbox and production environments based on the credential configuration.
- No additional external dependencies are needed beyond the Square API access.
Troubleshooting
Common issues:
- Invalid or missing Customer ID will cause the API call to fail.
- Network or authentication errors if the API key is incorrect or expired.
- If the customer does not exist, the API returns an error which the node surfaces.
Error messages:
"error.message"from the Square API will be shown if the customer is not found or the request is malformed.- To handle errors gracefully, enable the "Continue On Fail" option in the node settings to prevent workflow interruption.
Resolution tips:
- Verify that the Customer ID is correct and exists in your Square account.
- Ensure the API key credential is valid and has appropriate permissions.
- Check network connectivity and Square service status.