LOOKING FOR PARTNERS 🤝

We're currently looking for partners and distributors in different regions. If you're interested, please feel free to contact us.

Square Customers syncs with Salesforce Contacts

Sync Square and Salesforce Contacts

Learn how to sync your Square and Salesforce contacts using the SyncPenguin platform


Free 14-day trial with full support, no credit card required

Customers you capture at the Square register or online checkout often never reach Salesforce, where your sales and service teams manage relationships. Reps can't see in-store buyers, and customer details updated in Salesforce don't make it back to Square for checkout. Exporting and importing CSV files is slow and error-prone, and it leaves you with duplicates and outdated records in both systems.

How SyncPenguin helps

SyncPenguin connects your Square customer directory with Salesforce Contacts and keeps them in sync automatically, one-way or in both directions. New Square customers can appear in Salesforce as contacts, with their company linked to the right Account. Updates made by your team in Salesforce can flow back to Square. Using no-code filters and rules, you decide which customers sync, for example only a VIP or wholesale group. You can also tag synced contacts with a lead source or map details like Square customer groups and reference IDs to your own Salesforce custom fields.

Best suited for: Retail and e-commerce business owners. Sales teams following up with in-store buyers. Service businesses such as salons, studios and clinics. Marketing and CRM administrators.

Real-world use cases

  • Automatically create a Salesforce contact for every new Square customer and set the Lead Source to 'In-Store', so sales can follow up with walk-in buyers.
  • Two-way sync Square customers with Salesforce contacts, so phone numbers and addresses updated by sales reps are also correct at the Square checkout.
  • Sync only members of a Square 'Wholesale' or 'VIP' customer group to Salesforce and store their group names in a custom multi-select picklist field.
  • Send Salesforce contacts with a custom 'Square Customer' checkbox to Square, so B2B clients closed by sales are ready for in-person or invoice payments.
  • Map the Square customer Reference ID, such as a loyalty or membership number, to a custom Salesforce text field for reporting and segmentation.
  • Combine Square in-store customers and Shopify online customers in Salesforce, tagging each contact with a different lead source to tell them apart.
  • Sync Square customers to Salesforce, then share Salesforce contacts with reps' Outlook or Microsoft 365 contacts so they recognize customers when they call.
  • Bring Square customers into Salesforce and push contacts with a 'Newsletter' checkbox to a Mailchimp audience for targeted campaigns.
  • Keep the same customer details in Square, Salesforce and QuickBooks, so checkout, sales and invoicing all use accurate names, emails and addresses.

Key features

Two-Way Sync

Keep Square customers and Salesforce contacts updated in both directions, or push changes one way only. New records, edits and deletions are handled automatically.

Fast Square Updates

Square notifies SyncPenguin when customers change, so new and updated in-store customers reach Salesforce quickly.

Account Linking

A Square customer's company is automatically linked to the matching Salesforce Account. If no matching Account exists, one is created.

Group-Based Filters

Sync only the customers that matter to sales, such as Square VIP, loyalty or wholesale groups, using simple no-code filters.

Custom Fields

Map Square details like customer groups, reference IDs and notes to your own Salesforce custom fields, including text, checkboxes and picklists.

Affordable & Scalable

With SyncPenguin you only pay for changes to your data, regardless of how many contacts you have now or will have in the future.

Things to note

  • Your Salesforce edition must include API access. This is included in Enterprise, Unlimited, Performance and Developer editions, and available for Professional edition as an add-on.
  • Square stores one email, one phone number and one address per customer. When syncing from Salesforce, the work value (or the first available one) is used by default, and custom rules let you choose another, such as the mobile phone.
  • Square customer groups can be synced to Salesforce and used in filters and rules, but group membership is not changed in Square.
  • Square custom attributes and Salesforce custom lookup (relationship) fields are not currently supported. Standard fields and most Salesforce custom field types are fully supported.
  • Salesforce requires a last name. Square customers with only a first name are saved with that name as the last name, and profiles with no name, company, email or phone are skipped.
  • Companies are matched to Salesforce Accounts by exact name, and a new Account is created when no match exists.
  • Square changes are picked up within minutes, while changes made in Salesforce are synced during regular sync runs, so they may take a little longer to appear in Square.

How to configure the sync?


This guide explains in detail how to create, configure, and start the sync.

If you'd like to start syncing right away, feel free to create an account and set up the sync on your own. Come back to this guide if anything is unclear. You can also contact us with any questions, requests, or feedback.

Step 1. Create a SyncPenguin account

The first step is to create a SyncPenguin account. We offer a free 14-day trial (no credit card required), so you can make sure everything works well before you commit. Follow the link below to create an account.

14-day free trial • no credit card required • quick setup

Step 2. Create the sync

Next, create a sync in the Synchronizations section of the dashboard by clicking the + New sync button. You'll see a wizard page where you need to do the following:

  • Choose Square Customers for the first app.
  • Then choose Salesforce Contacts for the second app.
  • Then select the sync direction.
  • Then click the Create button.

Step 3. Provide access to Square and Salesforce

Now that your sync is created, the next important step is to grant SyncPenguin access to your contact data. You'll see an Account section for each app involved in the sync. Below we explain how to connect and configure each account.

How to connect Square?

This is a preview of the connection form in your SyncPenguin dashboard, shown for illustration only. Don’t enter any credentials here.
The Square Customers account connection section will look like this:

Account for Square Customers (Example)
Square Customers

How to connect Salesforce?

This is a preview of the connection form in your SyncPenguin dashboard, shown for illustration only. Don’t enter any credentials here.
The Salesforce Contacts account connection section will look like this:

Account for Salesforce Contacts (Example)
Salesforce Contacts

Please make sure both apps are properly connected before starting the contact sync.

DATA SECURITY

If you're concerned about the security of your data, please check out our Security Practices page.

Step 4. Sync settings

In the Sync settings section, you can adjust some of the default settings of your sync:

  • The name of your sync.
  • Sync direction (two-way or one-way).
  • Sync interval (by default, the sync runs every 10 minutes).

Please note that this connection uses webhooks, so syncing will be near real-time in most cases. The syncing interval is used as a fallback in case a webhook was not fired.

Additionally, in Field mappings & rules you can customize how contact data is mapped between the apps, or add filters and custom rules to the sync. This is done using our simple no-code visual interface, which lets you make simple adjustments as well as implement complex custom scenarios.

Supported Square fields: First name Last name Company Notes Reference ID Birthdate Email Phone Address Customer groups (read-only)
Supported Salesforce fields: First name Last name Salutation Job title Department Company (Account) Email Phone numbers Addresses Birthdate Description Lead source Assistant name Custom text fields Custom email, phone & URL fields Custom long text fields Custom checkbox fields Custom number, currency & percent fields Custom date fields Custom picklist fields Custom multi-select picklist fields

Virtually any syncing behavior based on supported fields is possible using the customizations interface.

Learn more about our customization interface.

Sync settings

Step 5. Start the sync

The last step is to start the sync. To do that, click the Start syncing button.

You'll then be offered the following options:

  1. Only sync new data, meaning anything added or updated from now on.
  2. Merge all historic data two-way: take all Square Customers and Salesforce Contacts and merge them together. Any data that already exists in both apps is merged instead of being duplicated.
  3. Merge Square Customers into Salesforce Contacts: take all Square Customers and add/merge them into Salesforce Contacts.
  4. Merge Salesforce Contacts into Square Customers: similar to the previous option but in the opposite direction.
Start sync
We'll be checking every 10 minutes for changes in your data.
What should we do initially with already existing contacts?

Once you've made your choice, click Start syncing. If you choose an initial merge, it'll be queued immediately. Once it's done, we'll check for contact changes at the sync interval you've set and sync them accordingly. Each sync run is shown in the Sync history at the bottom of the sync page.

Learn more

Frequently Asked Questions

Can I sync Square customers to Salesforce automatically?

Is the Square and Salesforce sync one-way or two-way?

Will syncing create duplicate contacts in Salesforce or Square?

Which fields are synced between Square and Salesforce?

Can I sync only some Square customers to Salesforce?

Can I test the integration before going live?

Do I need technical skills to connect Square and Salesforce?