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 Freshdesk Contacts

Sync Square and Freshdesk Contacts

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


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

Customers you add at the register or online in Square often never reach Freshdesk. When those buyers contact support, agents may start from scratch, with missing phone numbers, outdated addresses, or no record of who the customer is. Copying customers between Square and Freshdesk by hand takes time and leads to typos, duplicate contacts, and details that stop matching across the two systems.

How SyncPenguin helps

SyncPenguin connects your Square customer directory with Freshdesk Contacts and keeps them in sync automatically, in one or both directions. New Square customers can appear in Freshdesk before they ever open a ticket. Contact details your agents correct in Freshdesk can flow back to Square. With no-code filters, field mapping, and custom rules, you choose which customers are synced and how. For example, you can turn Square customer groups into Freshdesk tags, keep the Square reference ID in Freshdesk's External ID field, or sync only customers who have an email address.

Best suited for: Retail and restaurant owners using Square. Customer support teams and helpdesk managers. Service businesses that take payments with Square. Operations managers handling POS and support tools.

Real-world use cases

  • Automatically create a Freshdesk contact for every new Square customer, so agents already know the buyer when the first ticket arrives.
  • Sync Square customer groups to Freshdesk tags, so VIP or Loyalty members are easy to spot and can be routed with Freshdesk automations.
  • Two-way sync contact details, so a phone number or address that an agent corrects in Freshdesk is also updated in Square for checkout and receipts.
  • Sync only Square customers who have an email address to Freshdesk, and store the Square reference ID in the Freshdesk External ID field for easy lookups.
  • Copy Square customer notes and birthdates into the Freshdesk description and a custom date field, so agents can give more personal support.
  • Combine in-store Square customers and online Shopify customers into one Freshdesk contact list for a unified support view.
  • Send new Square customers to both Freshdesk and a Mailchimp audience, so the same buyers receive support and marketing follow-ups.
  • Sync Square customers to Freshdesk and to the Microsoft 365 Global Address List, so support and office staff can find customer details in Outlook.
  • Keep Square, QuickBooks, and Freshdesk customer records aligned, so point of sale, billing, and support all use the same names, emails, and addresses.

Key features

Two-Way Sync

Keep Square customers and Freshdesk contacts aligned in both directions. You control whether new, updated, and deleted records sync in each direction.

Near Real-Time

Square notifies SyncPenguin about customer changes, so new buyers and updates reach Freshdesk within minutes.

Groups to Tags

Map Square customer groups such as VIP, Loyalty, or Wholesale to Freshdesk tags, and use them in filters and rules.

No Duplicates

Smart matching by email links existing customers and contacts during the initial merge, so your helpdesk stays clean.

Custom Fields

Map Square fields like birthdate, reference ID, or notes to Freshdesk custom contact fields, the External ID, or the description.

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

  • Square stores one email, one phone number, and one address per customer. When syncing from Freshdesk, the primary email and the work phone (or the first available) are used. You can choose differently with custom rules.
  • Freshdesk stores one work phone and one mobile phone per contact, and each email address must be unique in Freshdesk.
  • Square customer groups can be synced to Freshdesk (for example, as tags) and used in filters, but group membership is not changed in Square.
  • Square custom attributes are not currently supported. All standard Square customer fields are supported.
  • Freshdesk contacts are linked to a single company matched by name, which is created automatically if it doesn't exist yet. Other company details are not synced.
  • Square customer profiles without a name, company, email, or phone are skipped because they contain no useful contact information.
  • Requests to Freshdesk are paced to stay within API limits, so the first sync of a very large customer list may take longer than later updates.

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 Freshdesk Contacts for the second app.
  • Then select the sync direction.
  • Then click the Create button.

Step 3. Provide access to Square and Freshdesk

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 Freshdesk?

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

Account for Freshdesk Contacts (Example)
Freshdesk 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 Freshdesk fields: First name Last name Full name Job title Company Emails (primary and additional) Phones (work and mobile) Address Description Tags External ID Language Time zone Active (verified) status Custom text fields Custom paragraph fields Custom number fields Custom dropdown fields Custom checkbox fields Custom date fields Custom URL fields Custom phone number 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 Freshdesk Contacts and merge them together. Any data that already exists in both apps is merged instead of being duplicated.
  3. Merge Square Customers into Freshdesk Contacts: take all Square Customers and add/merge them into Freshdesk Contacts.
  4. Merge Freshdesk 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 with Freshdesk contacts automatically?

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

What do I need to connect Square and Freshdesk?

Will syncing create duplicate contacts in Freshdesk?

Can I sync only certain Square customers to Freshdesk?

Can Square customer groups become Freshdesk tags?

What happens when a customer is deleted?