Square Customers (Free)

This Bubble.io plugin will allow you to manage and sync Square customer profiles with your Bubble.io app.

Square API Reference Documentation

Forum: Help - Feedback - Feature Requests

Plugin Page: Purchase - Ratings

Key Concepts

Addresses

Addresses are formatted differently depending on the country, please see the Square documentation: Working with Addresses

Page Cursor

The List and Search actions allow pagination if there are more results than the specified limit.

If there are more results to be returned on the next 'page', a text string called a Cursor is returned which can be used in a repeat of the same workflow action to give the next page's results.

Workflow Actions

Create Customer

Creates a new customer for a business. You must provide at least one of the following values in your request to this endpoint:

  • given_name

  • family_name

  • company_name

  • email_address

  • phone_number

Retrieve Customer

Returns details for a single customer.

Update Customer

Updates a customer profile. To change an attribute, specify the new value. To remove an attribute, specify the value as an empty string.

Delete Customer

Deletes a customer profile from a business. This operation also unlinks any associated cards on file.

List Customers

Lists customer profiles associated with a Square account.

Search Customers

Fuzzy searches the customer profiles associated with a Square account using one or more specified attributes (Email Address, Phone Number and Reference Id)

Calling SearchCustomers without any explicit query filter returns all customer profiles ordered alphabetically based on given_name and family_name.

Additional Information

  • It can sometimes take a few minutes for a newly created customer profile to be returned using the List or Search actions.

  • It is recommended to store Phone Numbers in E.164 format.

Possible Roadmap

  • Custom attributes.

  • Customer groups and segments.

Last updated

Was this helpful?