[Direct Mail for Mac](http://directmailmac.com) makes managing your email marketing campaigns easy. No headaches. Just results.


directmailmac

Direct Mail for Mac

Create Online Forms with a simple Drag-and-Drop tool. Build complex workflows, Sell Online, conduct Surveys, and more. No Coding.

unnamed (4)

123FormBuilder

<InfoBox>**[GETTING STARTED GUIDE](/help/features/getting-started/): How to set up a new connection?** </InfoBox>

<InfoBox>[**ALL FEATURES EXPLAINED**](/help/features): **All our features/functionality explained in detail - no app-specifics.** </InfoBox>

**Direct Mail for Mac** makes managing your email marketing campaigns easy. No headaches. Just results.  

**Below you'll find detailed information, specifically for Direct Mail for Mac integrations:**

## Supported Direct Mail for Mac Integrations

<Widget src="https://cdn.piesync.com/widget.js" left="directmailmac" />

## Authorizing Direct Mail for Mac

We simply ask your login details and your permission.

**For Direct Mail for Mac, we need your API _key ID_ and the _key secret_.** (Make sure you've [moved your project to the cloud](http://directmailmac.com/support/article/422) first.)

**You can find these by clicking the _Direct Mail_ menu > _Direct Mail Account_ > scroll down to _API Access_ > _Show_.  Copy & paste the key ID and the key secret into the authorization pop-up window.**

**Next, click the _File_ menu > _Share_ > (_Move to Cloud_ if needed) > the _API_ drop-down menu in the bottom left corner > _Grant Access to API Keys_ > select the appropriate API Key (i.e. the one you entered in the Key ID field) > _OK_.**

For Direct Mail for Mac, we need **authorization per project and address group**. This means you need to set up a **new connection for each project/address group** you want to keep in sync. You can choose from all your existing projects/address groups in the authorization step after entering your login details.

![](//images.ctfassets.net/f2ysq090txql/3g6MIEWbAbZ8fzAyCST0qO/38fce782d9d8ffbdd6bfdfc61bbe3c9a/screen-shot-2018-03-26-at-07-49-11.png)

![](//images.ctfassets.net/f2ysq090txql/3dlS5DevgJ8BfDM0m8v3C0/74137c874bf5d891b237bab4ee8f543b/2.png)

![](//images.ctfassets.net/f2ysq090txql/2QlTsnTushnr98u6jPDow3/ccd884e160005733534ba6eafaae11c2/3.png)

If you already authorized Direct Mail for Mac account(s)/project/address group in the past or in any other PieSync integration, you'll be able to the first part of the authorization and choose from your **CONNECTED ACCOUNTS**.  

![](//images.ctfassets.net/f2ysq090txql/7zbKBS81iE5Ulkpxod7R5D/163acd0b1240435640e24318bb0e8081/4.png)

## \[IF\] Supported Conditions/Filters

*   BOUNCE STATUS
*   UNSUBSCRIBED STATUS
*   FIELD VALUES (_INCLUDING CUSTOM FIELDS_)
*   ALREADY EXISTING IN APP YOU SYNC WITH 

![](//images.ctfassets.net/f2ysq090txql/3z3klgBFg369Clwdm4Jaro/b64a02e950f95c093aa56c0042d4c6c3/5.png)

![](//images.ctfassets.net/f2ysq090txql/vJMiwKYm2zR76k3jocNji/ab3e451b59e5b272ea9a0db031db3aed/6.png)

## \[THEN\] Supported Actions

*   UPDATE BOUNCE STATUS
*   UPDATE UNSUBSCRIBE STATUS
*   UPDATING FIELD VALUES (_INCLUDING CUSTOM FIELDS_)

![](//images.ctfassets.net/f2ysq090txql/5SF2X55puci9R9IHgXX1iN/8ed0a6c6b3f096d4e910b3ee90efd695/7.png)

![](//images.ctfassets.net/f2ysq090txql/19sXFgWsCheenbibRtYNph/ab40fdf7ed63cabc7e78c581b0960095/8.png)

## Default Field Mapping

Depending on the other app you're syncing with, you'll see a number of standard Direct Mail for Mac fields being mapped by default. For instance, in a connection with Google Contacts, the default field mapping looks like this:

![](//images.ctfassets.net/f2ysq090txql/3rhtx0oZnDsZ3F6HxJigZv/ae1f07dce1f9e78f25ec1057ba7158f0/9.png)

<InfoBox>PieSync syncs the default name field(s) that come with the apps. Sometimes they have a different structure in both apps you connect. E.g. first and last names are separate in app A and joint in a single field in app B. In the background, PieSync joins first and last names together from app A to B and separates them again from app B to A. Our algorithm is smart about which part it updates in app B</InfoBox>

## Customizable Field Mapping

You can custom map your Direct Mail for Mac Custom Fields and any additional standard fields that aren't included in the default mapping yet. Bear in mind a mapping between two fields can only exist if the types of fields are compatible and the particular compatibility will determine the direction of the mapping as well. More information on Customizable Field Mapping [**HERE**](/help/features/new-customizable-field-mapping/). 

![](//images.ctfassets.net/f2ysq090txql/7HKJaYLLjl6SQwBEIMERnp/aba8b0878e7e094264d340ae6522c978/10.png)

## Additional Options

### Syncing Unsubscribes/Deletions

Currently, there are no Direct Mail for Mac integrations on the PieSync platform that support our [Deletions](/help/features/syncing-deletions/) sync.

In connections with Direct Mail for Mac where adding a tag in app B is a supported trigger, you are able to [sync unsubscribes](/help/features/syncing-unsubscribes/) one-way. When a contact unsubscribes in Direct Mail for Mac, we add the tag 'PieSync\_Unsubscribes' to that same contact in app B. You will be able to review this segment first before e.g. deleting or taking action on that side of the sync.

![](//images.ctfassets.net/f2ysq090txql/45bQSsCt8VmRisB3IzcoVJ/d7361943d0457070115d301ef4112131/11.png)

<InfoBox>The availability to Sync Unsubscribes/Deletions is app and connection dependent. If the box (screenshots above) is not there to tick, it's simply not possible. We need to be able to detect unsubscribes/deletions on one side and at the same time be able to create add the tag 'PieSync Unsubscribes' or ‘PieSync Trash’ on the other side. More Information on Syncing Unsubscribes [here](/help/features/syncing-unsubscribes/) or on Deletions [here](/help/features/syncing-deletions/).</InfoBox>

<TipBox>Thanks to the feedback we have already received, we created a list of popular apps that we’re going to work on very soon. By [voting them up in our pipeline](http://www.piesync.com/connections/#vote), YOU decide which connectors we’ll release first. If you don’t see your app on the list or need any further help, drop us a line - support@piesync.com.  **Don't forget to read our [blog](http://blog.piesync.com/) for the latest in productivity, apps, and technology!**</TipBox>

GETTING STARTED GUIDE: How to set up a new connection? ALL FEATURES EXPLAINED: All our features/functionality explained in detail - no app-specifics. Direct Mail for Mac makes managing your email marketing campaigns easy. No headaches. Just result...

How to set up specific apps, what rules are available and mapping overviews

Supported Apps

## What is possible? 

### Contacts 

The beating heart of our syncing engine can help you with keeping your contact information in sync, at all times. 

Depending on the app you're using, you might see alternative names such as Audiences, Customers, Users, etc.
The basic principle is that we display the same name as the entity the app uses as its contact repository. 

In the example below, we are syncing contacts between HubSpot and QuickBooks. In this case, the respective contact repositories are called "Contacts" and "Customers":
![Screen_Shot_2020-06-17_at_18_54_14.png](//images.ctfassets.net/f2ysq090txql/6QtXWvDkZby3VGbRueaieA/b1869c44db996b8e5b63234cfa6f5760/Screen_Shot_2020-06-17_at_18_54_14.png)

### Leads

Similar to our contact sync, our engine is also able to sync the leads entity in your apps. 

<InfoBox> Learn more about our Leads sync [here](https://www.piesync.com/help/faq/syncing-leads/ "Syncing Leads"). </InfoBox>

#### Some key take aways: 

- Some applications have a standalone Leads entity. PieSync is able to incorporate that in the sync. You can choose which contact type you wish to sync during the 3rd step of the configuration process, as shown in the example below for Microsoft Dynamics 365:
![Screen Shot 2020-06-17 at 20 09 24](//images.ctfassets.net/f2ysq090txql/7LMmtESf1P17iJx6aqGPId/fc8ee1f5f550b1cb8b04ff6a42a13654/Screen_Shot_2020-06-17_at_20_09_24.png)

- It might be that your application doesn't have a leads entity, while you can see leads in your account. In such cases, the leads are stored within the Contacts section and distinguished by a particular field (e.g "Status"). We are able to incorporate those in the sync as well. 


### Companies

Also known as "Accounts" or "Organizations", this is the third entity that PieSync is able to sync. It does come with a nuance though.

- Our companies sync is only available for a limited number of applications. A full overview of the supported apps can be found at the bottom of [this page](https://www.piesync.com/help/faq/can-i-sync-company-account-information/ "Syncing Company / Account info").

- PieSync only offers a company to company sync. This means companies or accounts can't be synced to a contact entity. Doing so will result in the following error message: "The selected combination of entities cannot be synced"
![Gif KB](//images.ctfassets.net/f2ysq090txql/6g2SKlBqZ5ohwXATA8uYX1/77dea4fe62601ad7c3984637d9e1d0d0/Gif_KB.gif)

- For some integrations, PieSync is able to expose Company related fields when syncing Contacts. This allows you to sync company related information on the contact level. 
More information on this can be found [here](https://www.piesync.com/help/faq/syncing-company-related-information-on-contact-level/)

When available, these fields will be visible in the sync configuration as shown in the example below:
![Screen Shot 2020-06-17 at 21 11 39](//images.ctfassets.net/f2ysq090txql/nkle72OLNjoqH01AmkKCj/2119244dc2be432fe3ff011dd5ff046e/Screen_Shot_2020-06-17_at_21_11_39.png)
<InfoBox> Learn more about the possibilities of our Companies sync [here](https://www.piesync.com/help/faq/can-i-sync-company-account-information/ "Syncing Company / Account info"). </InfoBox>


## What PieSync doesn't sync today 


- Deals / Opportunities. 
- Tasks
- Notes / Logs / Activities
- Orders / Products
- Emails
- Invoices / Quotes
- Campaigns
- Custom Objects

At this point, we focus on syncing your contact data. The entities listed above cannot be synced at the moment. However, this doesn't mean we won't support them in the future. On the contrary! Our developers are currently working on ways to implement some of these features as well.

Feel free to share what you'd like to sync through [this small survey](https://piesyncforms.typeform.com/to/Erb2jN "typeform").
It only takes a few minutes and allows us to capture valuable feedback regarding the priority of these features. 

Additionally, by filling in this survey, you’ll automatically receive a notification when the feature you’re looking for is being launched.


What is possible?  Contacts  The beating heart of our syncing engine can help you with keeping your contact information in sync, at all times.  Depending on the app you're using, you might see alternative names such as Audiences, Customers, Users,...

Get personalized help for all kinds of errors as well as unexpected behavior in your syncs

What does PieSync sync? 

## 5 quick steps to do before you hit "Sync!"

![](//images.ctfassets.net/f2ysq090txql/54ScpBCj0sW99qoJjUfpuR/86ae7b3b17adbd3463fd0bf62dc4f5d4/larry.gif)

<InfoBox>Hesitant to "Start syncing now" after you configured a sync?  
Follow these steps to gain peace of mind! </InfoBox>

**1) Pause other syncs to your apps**

Turn off or pause any existing integrations in parallel (other PieSyncs, Zapier, Fullcontact, etc). Leaving these syncs on can lead to unpredictable results. Check your CRM's account settings, you may already be syncing some data (one way).

**2) Back up your data**

In the next step, we'll give you some tips on cleaning up your data. That's why it's wise to make a backup first should you be too enthusiastic in cleaning contacts. [Google Contacts, Icloud, ContactsPlus save a temporal state of your Contacts so you can always go back to a state prior to a sync](/help/want-to-learn-more/revert-a-sync/). Have contacts on your phone? [Here's a checklist.](/help/faq/get-your-phone-contacts-in-sync/)

**3) Time to clean**

Delete contacts you won't ever need anymore. You may want to empty Google's ["Other Contacts" folder](https://support.google.com/mail/answer/1069522?hl=en&visit_id=1-636459121173695326-1876924094&rd=1) filled with legacy contacts. Make sure your source & target data is rid of duplicates. Use the “find & merge duplicates” features of Google/iCloud/Outlook or from your CRM. 

*   [Instructions for Google Contacts](https://support.google.com/mail/answer/1069522?hl=en) (+ [9 extra tips provided by FullContact](https://www.fullcontact.com/blog/clean-up-google-contacts/))
*   [Instructions for iCloud](https://support.apple.com/en-us/HT203565)
*   [Instructions for Outlook.com](http://ccm.net/faq/39487-outlook-com-how-to-remove-duplicate-contacts)
*   [Instructions for CRM, for example Pipedrive](https://www.google.com/search?q=dedupe+pipedrive+contacts)

Once the sync is started, you can continue performing these clean up operations. PieSync [can detect cleaning](/help/want-to-learn-more/cleaning-up-duplicates-in-your-crm/) up contacts.

**4) Do a sanity check**

Perform a human check on whether the find&merge duplicates did its job. Merge whichever duplicates that weren’t detected automatically, delete old contacts or old addresses. By default, PieSync will only sync contacts that have an e-mail address, which is what we then use on the other side of the sync to keep your contacts unique. 

**5) Run a test sync**

If you want to test PieSync on a limited dataset, you can apply some intelligent rules to narrow down the sync. 

<Embed src="//www.youtube.com/embed/Bk_OSkK-JvQ" />

  

*   For instance, adapt rules to only sync contacts with a specific dedicated test-tag, and have it update a specific field on the other side as extra proof. If you only tag one contact in your CRM with this very specific tag, only this contact will sync. The other contacts remain untouched.![](//images.ctfassets.net/f2ysq090txql/4H8IOtuSEcAwFFWpEMv4A4/4315bb78f5091ac100c72fcc71ac5f69/blob)
*   Don't have tags in your app? Consider creating a test contact with a dummy or test e-mail address and only leave this rule enabled. Works just as well. Just know that sometimes a dummy e-mail address won't get created inside your ESP client.
    
    ![](//images.ctfassets.net/f2ysq090txql/3B3AD2S36pvyK2G2UtmyfS/b460cd55b694b72ea77f9a1f4e57f04e/blob)
    
*   Furthermore, you can always disable rules to prevent contacts from being created into an environment where you want to avoid unexpected contacts from being pushed towards! 
    
    ![](//images.ctfassets.net/f2ysq090txql/2HCSnFK21Pn9hVNi3Q1yTV/99282c381394ca36cbfc1bc7e6e1e1d1/screen-flow.gif)
    

[What are you waiting for? Start syncing! ](/help/features/getting-started/)

<TipBox>Still in doubt? Feel free to [schedule a call](https://calendly.com/piesync) with our support team.</TipBox>

5 quick steps to do before you hit "Sync!"  Hesitant to "Start syncing now" after you configured a sync? Follow these steps to gain peace of mind! 1) Pause other syncs to your apps  Turn off or pause any existing integrations in parallel (other Pi...

Want to learn more?

Preparing your data for PieSync

<Embed src="https://www.youtube.com/embed/mwH6sLjgIVg/" />  

By default, an iPhone will store contacts on iCloud, or, if you've opted out from iCloud, it will store them locally on your phone. How do you get these contacts synced up to other services? It all depends on where they are now! 

*   If your iPhone contacts are stored in iCloud, you can choose to [sync your contacts from iCloud directly to many of PieSync's other supported apps](http://www.piesync.com/icloud/).
*   If you're not using iCloud, you should consider moving your contacts to a cloud service, as only then will PieSync work.

**But even if your contacts are currently stored in iCloud**, and [PieSync supports iCloud](http://www.piesync.com/icloud/), you may want to make sure your iPhone uses Google Contacts instead, especially if the rest of your business runs on Google apps.

## Managing multiple contact lists on an iPhone

A quick way to find out which contacts are currently loaded up on your iPhone, is by going inside the **Contacts app**, or the **Phone app** of your iPhone.

By tapping the **Groups** icon on the top left, you'll understand that an iPhone is capable of visibly merging different databases into one single contact list.

While in some cases it is handy to have your iPhone consolidate contact lists, in most cases it actually leads to **confusion.** Because everything is neatly merged, there is no easy way to recognize in which cloud database a specific contact is being stored.![](//images.ctfassets.net/f2ysq090txql/3R930qCIp77bn5CBEqOTug/e4937fa14b75e0b5e8fda7df552698f1/image.gif)

  
<InfoBox>Where is your mom's contact stored? Is it in iCloud? Google Contacts? Your SIM card? Worse yet, is it in all three of them simultaneously? Your iPhone actually dedupes them & merges identical contacts visually!  
  
The idea is ultimately that your phone merely acts as a window into contacts databases, so we suggest you visit [contacts.google.com](http://contacts.google.com) or [icloud.com/contacts](https://www.icloud.com/contacts) respectively to see & manage these lists.</InfoBox>

## Where are your contacts stored?

So how does your iPhone manage contacts? This help article can't possibly cover all possible scenarios, but here's how you can easily find out how your iPhone is setup currently.  
  
Go to **Settings -> Contacts -> Accounts** to find out which services are allowed to manage/add contacts on your phone. In the example shown to the left, there are three accounts moving contacts into this iPhone:  

1.  iCloud
2.  Personal gmail.com
3.  G-suite-domain

It's very likely you will see something different on your phone: you may or may not have iCloud, you could have an [Outlook](http://www.piesync.com/outlook-office365/) account, and so on.

![](//images.ctfassets.net/f2ysq090txql/4dGQCrcQjhwMJIrw3KAawL/d3544012e3d0b59539ad6b96943bd33b/image.gif)

<InfoBox>**Did you know?** Connecting a Google account to an iPhone will **import** your Google Contacts. However, the contacts that you had on your phone before **are not moved to Google**. They remain stored on iCloud or on your phone! Follow these instructions to back up those contacts to Google.</InfoBox>

The next steps will help you consolidate your contacts into Google's ecosystem instead. **Wherever your contacts are,** with the [**Google Drive app**](https://itunes.apple.com/be/app/google-drive-secure-online-file-storage/id507874739), you can push your Contacts data from your iCloud or those that are locally stored  to the Google Drive and into Google Contacts.

## Move your iPhone Contacts to Google Contacts with the Google Drive app

1. [Download Google Drive](https://drive.app.goo.gl/?link=https://drive.google.com/_/backup/ios&ibi=com.google.Drive&ius=googledrive&isi=507874739) to your iPhone and sign in with your Google account. If you don’t have a Google Account, you can create one when you sign-in to Google Drive. Already have Google Drive? Make sure it’s up to date.  

![Install Google Drive Google Contacts iPhone](//images.ctfassets.net/f2ysq090txql/6q1Oh3EUTKzpAGTWVZEGEB/d5c95a281c8ee1566fda9cd877aaaaa7/image.jpeg)

2. Now it’s time to backup your content. Open Google Drive and go to the backup wizard in Menu > Settings > Backup. You can select which content you want to backup or simply backup everything. Then hit “Start”.

3. Sign-in to your Google Account on your iPhone.  

![](//images.ctfassets.net/f2ysq090txql/6jkNFu6BAaqQcxVkxn2jpi/fea21e5327c83dfab643d375e4aacbdd/image.jpeg)

4. Go to your iPhone settings and **make sure your default account is the selected** **Gmail account**.This ensures that new contacts are added to Google Contacts and can then be synced to your cloud apps such as your CRM.

<InfoBox>Don't forget to set up the "Default account" to be Google! Merely connecting a Google account isn't sufficient, you also need to make sure new contacts you create on your phone are immediately created inside Google via this setting.</InfoBox>

<Embed src="https://www.youtube.com/embed/VlMm4q1wIn0/" />


  By default, an iPhone will store contacts on iCloud, or, if you've opted out from iCloud, it will store them locally on your phone. How do you get these contacts synced up to other services? It all depends on where they are now!  If your iPhone ...

Setting up your iPhone to sync with Google Contacts

Where possible, PieSync offers bidirectional field mappings (two-way). However, there are **some exceptions** where a mapping can only be set up one-way:  

*    When a **field cannot be modified** in the application you are syncing.

*   When a **field only allows some specific values**. In that case we do not allow writing to the field because we cannot guarantee the new value is allowed by the field. For example: dropdown, (multi)-select, status,... fields.

*   When **two mapped fields have different types** such as text, number, date,... In some of those cases we cannot guarantee a correct conversion in both sync directions. For example: the data in a number field can easily be converted to a text field, but not all text values can be synced back to the number field.

![](//images.ctfassets.net/f2ysq090txql/66hjCGL1zMNRiVjyVDJ1us/d5747886fa0d3aa4542c88c72e246cb6/image.png)
  
Bear in mind that the **general direction** of your connection affects your syncing behavior. When you have configured your connection as a one way sync in the other way (→), the following message will pop up.  

![](//images.ctfassets.net/f2ysq090txql/74uOD8xabUStQVtQHdm3MT/3c20b4f263730bd08520da5c66a942fd/image.png)

Where possible, PieSync offers bidirectional field mappings (two-way). However, there are some exceptions where a mapping can only be set up one-way:  When a field cannot be modified in the application you are syncing.  When a field only allows so...

Why can my fields only be mapped one-way?


## Step 1: Choosing your apps

In setting up a sync connection, you first choose [the apps](/help/faq/which-connectors-do-you-support/) that contain the contacts data you need synced. We have provided a handy search bar to quickly get to the apps you're looking for. After you select the first app, you immediately proceed to select the second app. We will connect to these apps in a second step.  

![](//images.ctfassets.net/f2ysq090txql/3KxQtwOhw5ZSMt8fYYXTfz/ee3e8abcd18d5947d5b84b9168a9ace3/screenshot-2019-05-20-at-15-18-15.png)

> We add new apps [every week!](http://www.piesync.com/connections/) 

Please reach out to us if you're not able to set up the combination you need - we might be able to help.

## Step 2: Authorize your apps

In order to use PieSync, you need to have registered accounts with the apps you selected. At this point, you'll need to connect PieSync to these apps so we can fetch the contacts data configuration. You do this for both apps. While the screenshots below are some examples, [the instructions for your app are listed separately on this page](/help/connector-apps). If it is the first time using PieSync, you will need to authorize both apps, one after the other.

![](//images.ctfassets.net/f2ysq090txql/1yIcstEdqicA8OeMVfSaUI/428747f5c872177d0df7e2eea579634b/image.jpeg)

If you have previously set up a connection with any of these apps, you can choose to re-purpose that authorization. Of course, you can also choose to login to your apps with a separate account too.

![](//images.ctfassets.net/f2ysq090txql/2reZkRSo7ZAWia7MPDV88B/04af9415b8c8fe7660a6e6c6996b651b/screenshot-2019-05-20-at-15-19-31.png)

## Step 3: Choose your contact type

Choose whether you want to sync Contacts or Leads. The availability to sync Leads depends on whether your app has a Leads entity

![](//images.ctfassets.net/f2ysq090txql/7Ak44LlJd6uTiQPVjMkPBu/2fd9180354747b46255728c013542995/screenshot-2019-05-20-at-15-30-18.png)

<InfoBox>This step will only appear if the applicable app has Leads available.</InfoBox>

## Step 4: Configure your sync

### 4.1 A two-way sync is made up by at least two rules

Once you authorized  2 apps, you tell PieSync how we should keep your contacts data in sync. By default, PieSync proposes a two-way sync with a drop-down to allow for one-way syncs ([do I need one-way or two-way?](/help/features/sync-direction/)).

![](//images.ctfassets.net/f2ysq090txql/7FOQ10iMP8cUSoUsuyH4oZ/a41f6387ed9676de2ec541d5f6074725/screenshot-2019-05-20-at-15-47-19.png)

A two-way sync starts off with 2 rules. Each rule fulfills the conditions of each side of the sync. PieSync looks at all the data stored on each side, so you can define exactly what data needs to move from one side to the other.

![](//images.ctfassets.net/f2ysq090txql/4WXwFvxUcgeOUEBZ17ujQu/d70d784e556e5bd2b797d3c583e78628/screenshot-2019-05-20-at-15-51-54.png)

> _In this  example, rule 1 dictates that for every contact that PieSync finds in Google Contacts, PieSync will update or create one in Copper in case it didn't exist already there. Rule 2 completes this 2 way sync: for each contact that exists in Copper, a counterpart will be updated or created in Google Contacts. For instance, if you don't need all of your Copper contacts into Google Contacts, simply remove this rule!_

If you need a simple all-to-all sync, this is all you need to set up (ie. don't change anything to the default setup). Starter plans are limited to two of these rules, but **the Pro plan and onward allow for more**. Why would you need more than 2 rules? Read on!

### 4.2) Adding conditions & actions

Your contacts don't behave the same way across apps:

*   In your marketing tool, customers are recipients that move across distribution lists and change subscriber status
*   in your invoicing tool, they have carefully kept address & contact information
*   In your contacts management tool linked to your phone, you expect to have their phone numbers and benefit from caller ID
*   In your e-commerce platform, new buyers become customers
*   ..And in your CRM, your customers should consolidate all of this information into a single view

Through PieSync you can and you should tweak the sync so that not only contacts get synced, but you also respect the segmentation, tags, groups, categories, custom attributes, subscription status, ... of the apps that the contacts live in. In a PieSync [rule](/help/features/multiple-rules/), you can choose to add a filter and add actions to syncs. 

![](//images.ctfassets.net/f2ysq090txql/7d7LBTtReimN4YR9MFzbVV/3c8dd3ac16c3881a11e57b45b95604bd/screenshot-2019-05-20-at-15-56-27.png)

> Good to know; in a two-way sync, PieSync will suggest to optionally undo & revert the actions so you can sync datasets in unison. In the above example, all of the contacts in Google Contacts label "Coworkers" are those that are in HubSpot's static list. If you remove contacts from the Hubspot list, they also get their Google Contacts label removed.

What you can do [depends from app to app](/help/faq/which-connectors-do-you-support/). Typically, it is in the if-clause that you'll be able to define a segment of your contacts. In the then-clause, you can perform actions such as adding the contacts to the counterpart of that same segment in the other app. Combine this with other actions you can perform as a result of a sync, and the possibilities are truly endless.

![](//images.ctfassets.net/f2ysq090txql/3pP2FN1NfJywOj07n89CWM/82bd11ed58dd49d4365684b1f3cfc726/screenshot-2019-05-20-at-16-18-46.png)

![](//images.ctfassets.net/f2ysq090txql/UR3fAVJo4MTSfRS4eojEg/dcc7b5e6a64730b63ac251bc1197ddc8/screenshot-2019-05-20-at-16-25-59.png)

> Our customers have come up with so many creative use-cases that help them maximize the benefits of their cloud-stack. 

### 4.3) Connection settings

In addition to setting up sync rules, PieSyncs presents a series of app-dependent options. These include: 

*   a toggle to help [AVOID DUPLICATES](/help/features/avoid-duplicates/) - possibly hard-coded by default
*   handy ways to have PieSync [SYNC DELETIONS](/help/features/syncing-deletions/) or [SYNC UNSUBSCRIBES](/help/features/syncing-unsubscribes/) across datasets
*   you should [CHOOSE YOUR MASTER APP ](/help/features/master-app/)so that during the initial sync and afterwards, conflicting changes can be resolved
*   in connections that include Google Contacts, we suggest you [ADDITIONALLY SYNC TO THE GOOGLE CONTACTS GROUP 'MY CONTACTS'](/help/features/my-contacts/), especially useful for iPhone users, as your iPhone contacts get synced to 'my contacts' in Google by default.

![](//images.ctfassets.net/f2ysq090txql/g07Md3qATNeSngQ4vptIj/d459cbab4f02c1268e13d4fdb9d1c3e6/image.jpeg)

> Options available under a Google-Mailchimp connection. The options under "connection settings" are app-dependent. If you do not see a particular option, the app does not support it unfortunately.

### 4.4) Field mapping

A contact is more than just a name. All your contacts attributes need to be carefully mapped with one another in a sync. 

*   PieSync's [DEFAULT FIELD MAPPING](/help/features/new-default-field-mapping/) shows you those default fields we will always keep in sync and details how we mapped them between the two apps you have connected. You cannot change these fields.
*   In the [CUSTOMIZABLE FIELD MAPPING](/help/features/new-customizable-field-mapping/), you'll be able to map fields stored in your apps that we didn't find logical counterparts for. This includes default fields as well as custom fields. The customizable field mapping is set up and shown in the white part below the default field mapping in the configuration. You can add an unlimited amount of mappings and remove, enable/disable them anytime. 

<InfoBox>Custom Mappings are available from the Pro Plan onward. More information on why you should upgrade to a Pro Plan [HERE](/help/faq/why-should-i-upgrade-to-medium-as-a-small-or-micro-subscriber/).</InfoBox>

![](//images.ctfassets.net/f2ysq090txql/6TYE1HpRDGiXLR90yDVcRy/2734fd39119f00201fa161b31d2af3f7/screenshot-2019-05-20-at-16-36-41.png)

### 4.5) Start syncing!

![](//images.ctfassets.net/f2ysq090txql/6CZH8gP8SUoaMOKgdB1lHD/bed220e9ac6040ae417e4bd3330c2631/image.png)

Make sure no other integrations are running next to PieSync for the accounts you have connected in PieSync. Other integrations will have access to your data and have the ability to manipulate as well. For this reason, we kindly ask you to use PieSync and nothing else to keep your data in sync. **Other integrations running in parallel with PieSync are a no-go!**

_In case you have a lot of contacts in your applications, the initial sync will take some time, even if you configured PieSync only to sync a subset of your contacts. During the initial scan, we need to process all of your contacts (also the contacts outside the chosen subset) to avoid duplicates during the sync. After the initial sync, it should never take much longer than five minutes for updates to show._

## Step 5: Monitor your connection in the Dashboard

Once the connection is running, the activity monitor will be your real-time view into PieSync's operations. It provides insight into: 

*   new contacts being created from your first app to your second app that didn't exist yet
*   new contacts being created from your second app to your first app that didn't exist yet (if you did a 2-way sync)
*   updates made to contacts that had been synced & matched up before: the update is now also synced up
*   whether your synchronization is active or not - you can pause the connection should you so wish

![](//images.ctfassets.net/f2ysq090txql/6sSzj03PVg91eb7tWh0LM/6e45073632cc0fcfaa72b696de1bf6c4/screenshot-2019-05-20-at-16-40-35.png)



## Optional: Want to become an expert in PieSync?
Follow Frans & Jan along [a one hour deep-dive](https://app.hubspot.com/academy/tracks/86/) on all things PieSync on the HubSpot Academy. 
[![Gif of the HubSpot Academy](//images.ctfassets.net/f2ysq090txql/5V3TGS0putUt844bcBLM6C/209bf5106150370d83c2f8d68274bade/ezgif.com-gif-maker.gif)](https://app.hubspot.com/academy/tracks/86/)

In setting up a sync connection, you first choose the apps that contain the contacts data you need synced. We have provided a handy search bar to quickly get to the apps you're looking for.

The essentials of setting up a two-way or one-way sync between your apps.

Getting started

Getting started with PieSync

microsoftdynamics

Microsoft Dynamics 365

Microsoft Dynamics 365 is a cloud-based CRM that focuses on intelligent customer engagement, and allows companies to market and sell more productively and smarter to their customers.  Native integrations to other Microsoft products make this a powerful CRM.


<InfoBox>[**GETTING STARTED GUIDE**](/help/features/getting-started/)**: How to set up a new connection?** </InfoBox>

<InfoBox>[**ALL FEATURES EXPLAINED**](/help/features): **All our features/functionality explained in detail - no app-specifics.** </InfoBox>

**Microsoft Dynamics 365** is a cloud-based CRM that focuses on intelligent customer engagement and allows companies to market and sell more productively and smarter to their customers. Native integrations to other Microsoft products make this a powerful CRM. Office 365 is Microsoft’s App suite and cloud collaboration tool and includes Microsoft Dynamics 365.

**Below you'll find detailed information, specifically for Microsoft Dynamics 365 integrations:**

## Supported MS Dynamics 365 Integrations

<Widget src="https://cdn.piesync.com/widget.js" left="msdynamics" />

This video sets up a 2-way sync between Microsoft Dynamics 365 and Chargebee.

<Embed src="//www.youtube.com/embed/0BsnntPXr9w" />

## Authorizing MS Dynamics 365

We simply ask your login details and your permission. **To Authorize your MS Dynamics 365 account, we need:**

1.  **Your Microsoft Dynamics 365 'Root Service Address', to be found in the URL of your application, it should end in** **_dynamics.com_.**
2.  **Your Microsoft Dynamics API version - you can retrieve this in the settings 'About' / The first 2 numbers represent the API version.**

![](//images.ctfassets.net/f2ysq090txql/7sI1xJX9Mz7VnkpymlI0w/617b7e80ad08b6f77e26ecaa49f71ce9/screen-shot-2018-04-24-at-12.57.02.png)

If you already authorized Microsoft Dynamics 365 account(s) in the past or in any other PieSync integration, you'll be able to the first part of the authorization and choose from your **CONNECTED ACCOUNTS**.

![](//images.ctfassets.net/f2ysq090txql/4ZPxvZI7fzN25q2GYKTuDY/21035ee991952b38aff628f905006823/2.png)

## Choose your contact type

Distinguish between Contacts, Leads or Accounts before proceeding to the configuration page.

![](//images.ctfassets.net/f2ysq090txql/J8O5ply6UCdgDOUWADNAG/94648eadbd8f0c7957a6325d242eee3f/screenshot-2019-09-19-at-11-51-37.png)

Learn about our contact sync below.

<TipBox>[Incorporate Company related information in a connection between Contacts.](/help/faq/syncing-company-related-information-on-contact-level/)</TipBox>

* More in-depth info about syncing Leads can be found [here](/help/faq/syncing-leads/).
* More in-depth info about our Company to Company sync can be found [here](/help/faq/can-i-sync-company-account-information/).

## \[IF\] Supported Conditions/Filters

*   OWNERSHIP
*   EMAIL OPT-IN/OPT-OUT STATUS
*   ACTIVE/INACTIVE STATUS
*   ALREADY EXISTING IN APP YOU SYNC WITH 
*   STATUS
*   CONTACT FIELDS (phone, address, ....)
*   CUSTOM FIELDS

![](//images.ctfassets.net/f2ysq090txql/3KvMf6itAsiSbG3TuaB7QQ/aee8e894df037ed7b8d1ab935bfd4d54/image.png)

## \[THEN\] Supported Actions

*   UPDATE (CUSTOM) FIELD VALUES 

![](//images.ctfassets.net/f2ysq090txql/7gbikvMZYKqbLXkp0oXdoV/a5bc9237df5200d84fa167fd41d85f85/image.png)

## Default Field Mapping

Depending on the other app you're syncing with, you'll see a number of standard Microsoft Dynamics 365 fields being mapped by default. For instance, in a connection with Google Contacts, the default field mapping looks like this:

![](//images.ctfassets.net/f2ysq090txql/QlV3gitBnFStAq6uU7sLs/5b1836dc3888b75c1e6d827850db310b/image.png)

<InfoBox>PieSync syncs the default name field(s) that come with the apps. Sometimes they have a different structure in both apps you connect. E.g. first and last names are separate in app A and joint in a single field in app B. In the background, PieSync joins first and last names together from app A to B and separates them again from app B to A. Our algorithm is smart about which part it updates in app B</InfoBox>

## Customizable Field Mapping

You can custom map your Microsoft Dynamics 365 Custom Fields and any additional standard fields that aren't included in the default mapping yet. Bear in mind a mapping between two fields can only exist if the types of fields are compatible and the particular compatibility will determine the direction of the mapping as well. More information on Customizable Field Mapping [**HERE**](/help/features/new-customizable-field-mapping/). 

![](//images.ctfassets.net/f2ysq090txql/1C36efxvVHD4Jj6hivmy9J/60d775b9fdc632a0e2c59c33dc6a31de/image.png)

## Additional Options

### Syncing Unsubscribes/Deletions

Currently, there are no MS Dynamics 365 integrations on the PieSync platform that support our [Unsubscribes](/help/features/syncing-unsubscribes/)/[Deletions](/help/features/syncing-deletions/) sync.

<InfoBox>The availability to Sync Unsubscribes/Deletions is app and connection dependent. If the box (screenshots above) is not there to tick, it's simply not possible. We need to be able to detect unsubscribes/deletions on one side and at the same time be able to create add the tag 'PieSync Unsubscribes' or ‘PieSync Trash’ on the other side. More Information on Syncing Unsubscribes [here](/help/features/syncing-unsubscribes/) or on Deletions [here](/help/features/syncing-deletions/).</InfoBox>

<TipBox>Thanks to the feedback we have already received, we created a list of popular apps that we’re going to work on very soon. By [voting them up in our pipeline](http://www.piesync.com/connections/#vote), YOU decide which connectors we’ll release first. If you don’t see your app on the list or need any further help, drop us a line - support@piesync.com.  **Don't forget to read our** [**blog**](http://blog.piesync.com/) **for the latest in productivity, apps, and technology!**</TipBox>

GETTING STARTED GUIDE: How to set up a new connection? ALL FEATURES EXPLAINED: All our features/functionality explained in detail - no app-specifics. Microsoft Dynamics 365 is a cloud-based CRM that focuses on intelligent customer engagement and a...

MS Dynamics 365

<Embed src=" https://www.youtube.com/watch?v=04xRku0dQcs"/>

The field mappings allow you to decide which contact data should be synced for each contact. Every connection comes equipped with a predefined list of mapped contact fields, which we call the "[Default Field Mapping](/help/features/new-default-field-mapping/)". This a list of the default contact fields that PieSync was already able to map. 

As of the Pro Plan, you are able to customize the default field mappings and you are also able to add your own field mappings. This is what we will discuss in this article. Any user-created mapping is also often referred to as the "**Custom (Field) Mapping"**.  

_Below you see an example of the field mapping between Pipedrive and ActiveCampaign. Of course, the list of default mapped fields is dependant on the apps you have connected and which (custom) fields you have available on both sides._

![](//images.ctfassets.net/f2ysq090txql/46XBGtEPZpRT2zCS9hrBjM/5fa119e33488e4d9bc769aac35a00717/screenshot-2019-05-15-at-21-20-17.png)

<TipBox>If you've just added a field in your app and it hasn't popped-up yet in the dropdown, then just press 'refresh field list' in the bottom right corner</TipBox>

### Changing the Default Field Mapping

As the default field mapping is a predefined list of mappings, some of the field mappings might not suit your use case. In that case, you are able to change that field mapping by:

1.  Disabling the mapping by setting the toggle to 'off'
2.  Adding a field mapping and selecting the two fields you want to connect instead.

_In the example below we wanted to remap the default mapping for 'Phone' <=> 'Work Phone' to 'Phone' <=> 'Home Phone' and 'Mailing Address' <=> 'Work Address' to 'Mailing Address' <=> 'Home Address':_

![](//images.ctfassets.net/f2ysq090txql/2qEbpfOnUAlYQnHoVw2qqn/49bff488ae2d340fe61e992de9f92711/screenshot-2019-07-12-at-15-33-15.png)

### Adding Custom Mappings

To add your own field mapping, simply click 'Add field mapping' below the Default Field Mapping. 

By default the custom mappings will sync in the direction you have set up in the configuration of your connection, so this could be either two-way or one-way. However, you are often able to change the sync direction of your custom field mappings.  

![](//images.ctfassets.net/f2ysq090txql/5mEsmPqVaLrsussQY8ZPNv/1be51718034ccba7380ddcd3eef52607/screenshot-2019-05-15-at-21-24-51.png)

### Custom mapping restrictions

[We've created an in-dept article to provide more information on this. ](https://www.piesync.com/help/faq/why-cant-i-custom-map-my-custom-fields-greyed-out/)



<TipBox>**Don’t forget to read our [Blog Post](http://blog.piesync.com/custom-fields/) about our Customizable Field Mapping feature!** </TipBox>

  The field mappings allow you to decide which contact data should be synced for each contact. Every connection comes equipped with a predefined list of mapped contact fields, which we call the "Default Field Mapping". This a list of the default c...

Customizable Field Mapping

kw logo

KWCommand

KW Command allows you to optimize, manage, and run your real estate business with unprecedented simplicity and insight, inside Keller Cloud. It is the centralized environment for everything a Keller Williams agent and their team must accomplish during any given day.

<InfoBox>[**GETTING STARTED GUIDE**](/help/features/getting-started/)**: How to set up a new connection?**</InfoBox>

<InfoBox>[**ALL FEATURES EXPLAINED**](/help/features): **All our features/functionality explained in detail - no app-specifics.**</InfoBox>

**KWCommand** allows you to optimize, manage, and run your real estate business with unprecedented simplicity and insight, inside Keller Cloud. It is the centralized environment for everything a Keller Willliams agent and their team must accomplish during any given day.

## Keller Williams use cases

Sync KWCommand with other **CRM's**

<Embed src="https://www.youtube.com/embed/dSA7Jz5aVKs?feature=oembed" />

Sync KWCommand with **marketing platforms**

<Embed src="https://www.youtube.com/embed/3Hwrva3taCw?feature=oembed" />

Sync KWCommand with **your phone**

<Embed src="https://www.youtube.com/embed/X4_qmmT79sM?feature=oembed" />

**Below you'll find detailed information, specifically for KWCommand integrations:**

## Supported KWCommand Integrations

<Widget src="https://cdn.piesync.com/widget.js" left="kwcommand" />

## Authorizing KW Command

To authorize KW Command, just go to KW Command settings & choose for PieSync. A PieSync account connected to your KW Command account will open automatically. Only if you are authorizing KW Command out of an existing PieSync account, we require your username and password.

![](//images.ctfassets.net/f2ysq090txql/2aUTokSLUGwysSLwxwrf8O/fc5c32da3c24a502b8a054f77cecf788/screen-shot-2019-02-11-at-10-17-10.png)

If you already authorized KWCommand account(s) in the past or in any other PieSync integration, you'll be able to skip the first part of the authorization and choose from your **CONNECTED ACCOUNTS**.

![](//images.ctfassets.net/f2ysq090txql/7n0PkfTKfKGUq7AeAIPVrh/4c5bd9425e566a71e4eb977a19af3c7c/screen-shot-2019-02-11-at-10-19-42.png)

## \[IF\] Supported Conditions/Filters

*   has Tag
*   Notes
*   Preferred Method of Contact
*   Stage
*   ...
*   Field values (_INCLUDING CUSTOM FIELDS_)
*   Already existing in the app you sync with

![](//images.ctfassets.net/f2ysq090txql/5Xw4mG1mrMq91obthDSEra/73f7a96ad507f259c0afd68932f7b2ac/screen-shot-2019-02-11-at-10-20-07.png)

## \[THEN\] Supported Actions

*   Add Tag / Remove Tag
*   Update Notes
*   Update Preferred Method of Contact
*   ...
*   Updating field values (_INCLUDING CUSTOM FIELDS_)

![](//images.ctfassets.net/f2ysq090txql/7oy0WLtPyaaQTPP2RcLlog/98e0cc15c6a009fa39996f56954b8e3c/screen-shot-2019-02-11-at-10-20-25.png)

## Default Field Mapping

Depending on the other app you're syncing with, you'll see a number of standard KWCommand fields being mapped by default. For instance, in a connection with Google Contacts, the default field mapping looks like this:

![](//images.ctfassets.net/f2ysq090txql/l3CYEINv8c0bMQ7JaJKRW/018b429a1731bf80828044a9261e1adf/image.png)

<InfoBox>PieSync syncs the default name field(s) that come with the apps. Sometimes they have a different structure in both apps you connect. E.g. first and last names are separate in app A and joint in a single field in app B. In the background, PieSync joins first and last names together from app A to B and separates them again from app B to A. Our algorithm is smart about which part it updates in app B.</InfoBox>

<WarningBox>Please note if the address mapping of a contact does not have the fields "street", "number" and "city" filled out, the address will not sync.</WarningBox>

## Customizable Field Mapping

You can custom map your KWCommand Custom Fields and any additional standard fields that aren't included in the default mapping yet. Bear in mind a mapping between two fields can only exist if the types of fields are compatible, and the particular compatibility will determine the direction of the mapping as well. More information on Customizable Field Mapping [here](/help/features/new-customizable-field-mapping/).

![](//images.ctfassets.net/f2ysq090txql/7m6blJNXOK4QGM2mCMIbAI/149807aedf44d25ecefb9f205ebb094a/screen-shot-2019-02-11-at-10-26-49.png)

## Additional Options

### Syncing Deletions

Currently, there are no KWCommand integrations on the PieSync platform that support our [deletions sync](/help/features/syncing-deletions/).

### Syncing Unsubscribes

Currently, there are no KWCommand integrations on the PieSync platform that support our [unsubscribes sync](/help/features/syncing-unsubscribes/).

<InfoBox>The availability to Sync Unsubscribes/Deletions is app and connection dependent. If the box is not there to tick, it's simply not possible. We need to be able to detect unsubscribes/deletions on one side and at the same time be able to create add the tag 'PieSync Unsubscribes' or ‘PieSync Trash’ on the other side. More Information on Syncing Unsubscribes [here](/help/features/syncing-unsubscribes/) or on Deletions [here](/help/features/syncing-deletions/).</InfoBox>

## Start Syncing

![](//images.ctfassets.net/f2ysq090txql/3nQhYJUmRlclrJ569OtsZG/b33520f099584b1dc75e38e3508981a2/screen-shot-2019-02-11-at-10-36-29.png)

Hit the "start syncing now" button once you have finalized your configuration. PieSync will first scan all your contacts in both applications, even if you only choose to sync a subset. This initial scan is necessary to [avoid duplicates](/help/features/avoid-duplicates/). After this scan, the synchronization will start! If you have a lot of contacts, this can take a bit longer. 

Have a look at the [PieSync dashboard](/help/features/pie-sync-dashboard-logging/) for an overview of your syncing activity. 

<WarningBox>Is your connection active but not showing activity feed, have a look at your [troubleshooting](/help/faq/troubleshooting/) to make sure everything is correctly set up.</WarningBox>

<TipBox>Thanks to the feedback we have already received, we created a list of popular apps that we’re going to work on very soon. By  [voting them up in our pipeline](http://www.piesync.com/connections/#vote), YOU decide which connectors we’ll release first. If you don’t see your app on the list or need any further help, drop us a line - [support@piesync.com](mailto:support@piesync.com).  **Don't forget to read our** [**blog**](http://blog.piesync.com/) **for the latest in productivity, apps, and technology!**</TipBox>

GETTING STARTED GUIDE: How to set up a new connection?  ALL FEATURES EXPLAINED: All our features/functionality explained in detail - no app-specifics.  KWCommand allows you to optimize, manage, and run your real estate business with unprecedented ...

<Embed src="https://www.youtube.com/watch?v=2T1cItj1ACA" />

Our pricing plans are based on the [amount of contacts](/help/faq/how-does-pie-sync-calculate-the-total-contact-count/)​ and features.

At the top of [**the page**](https://www.piesync.com/pricing/), there's an adjustable slider which correlates with the amount of contacts you wish to keep in sync.

![](//images.ctfassets.net/f2ysq090txql/YKcxkFCLdTYdPZ0kPenBg/abe56ffb4dca86a988959d1132b48914/nov-04-2019-13-55-04.gif)

To calculate the total contact count , we add up the unique contacts in sync PER connection. If the contact is present in two connections, we count that contact twice as these are two separate syncs we perform (we scan every 2-3 minutes) to keep that contact in sync continuously between the two particular apps in each connection.

<TipBox>The difference amongst the plans are defined by the features they carry.</TipBox>

**The Starter Plan**

1.  Entitled to use two [rules](/help/features/multiple-rules/) per connection.
2.  Custom mappings are not included.

**The Pro Plan**

1.  [Unlimited Rules](/help/features/multiple-rules/) 
2.  [Custom Mappings including Custom Fields](/help/faq/can-i-sync-custom-fields/)

You can always chose between a Monthly and Yearly plan. Shift the toggle on the pricing page to see the differences. 



<WarningBox>**Contact & Connection Limits:** If you exceed the contact limits, we will send you a few warnings prior to upgrading the account to the needed plan accordingly. _Your charge will be the pro-rated amount between your current plan and the upgraded plan._ </WarningBox>

<WarningBox>**Feature Limits:** You can always play around with Pro features such as custom mappings and unlimited rules in your configuration as a Starter subscriber. If you want to move forward and save and resume your sync including these, you'll need to upgrade first _(pop-up)_. _Your charge will be the pro-rated amount between your current plan and the upgraded plan._</WarningBox>

<TipBox>During (or after) your trial period, you can upgrade to a paid account on the Billing page. We recommend the right subscription based on your trial usage. All our plans are based on contact count and connection count limits. Only in the Pro plan you can use advanced sync features.</TipBox>

<InfoBox>_You can share any subscription with your_ [_team_](/help/account/teams/)</InfoBox>

[](/help/account/teams/)

**If you're still on a legacy plan and have further questions, please contact us at support@piesync.com  
**

  Our pricing plans are based on the amount of contacts​ and features.  At the top of the page, there's an adjustable slider which correlates with the amount of contacts you wish to keep in sync.  To calculate the total contact count , we add up t...

How to manage your PieSync account and set up billing

Account

Plans & Pricing

<Embed src="https://www.youtube.com/watch?v=Mn_MQWjYXh0&feature=emb_rel_pause"/>


With the IF/THEN rules you can dictate which contacts need to sync. Henceforth, we shall refer to these IF/THEN sentences as _rules_. 

By default PieSync will set you up with a two-way and all-to-all sync, which consists of a rule for each app without any [filters or actions.](/help/features/conditions-and-actions/)  
  

1. **TWO-WAY SYNC:** A two-way sync starts off with two rules by default. Each rule fulfils the conditions of each side of the sync. PieSync looks at all the data stored on each side, so you can define exactly what data needs to move from one side to the other and vice versa.

![](//images.ctfassets.net/f2ysq090txql/7yjUx0GH8GxbjMqSY0gkCm/8f7b4d93342592ab6a4738d14353e417/screenshot-2019-04-12-at-15-14-20.png)

  
In this example, the first rule dictates that for every contact that PieSync finds in Google Contacts, PieSync will update or create one in ActiveCampaign in case it didn't exist already there. The second rule completes this two-way sync: for each contact that lives in ActiveCampaign, a counterpart will be updated or created in Google Contacts. For instance, if you don't need all of your ActiveCampaign contacts into Google Contacts, simply remove this rule!  
If you need a simple all-to-all sync, this is all you need to set up (i.e., don't change anything to the default setup).

2. **ONE-WAY SYNC:** In a one-way sync, a rule based on the other direction won’t do anything. Hence it will be ignored.

![](//images.ctfassets.net/f2ysq090txql/2Q41mRPnivcuTt1ZRF7Y6f/eda6a2a950f7d282c2f40ac4c4005602/screenshot-2019-04-12-at-15-14-41.png)

  
3. **UNLIMITED RULES / SETTING UP MORE THAN 2 RULES:** [The starter](https://www.piesync.com/pricing/) plan is limited to two of these rules, but the [Pro and enterprise plan](https://www.piesync.com/pricing/) allow unlimited rules. Why would you need more than two rules?  
Your contacts don't behave the same way across apps:

*   In your marketing tool, customers are recipients that move across distribution lists and change subscriber status.
*   In your invoicing tool, they have carefully kept address & contact information.
*   In your contacts management tool linked to your phone, you expect to have their phone numbers and benefit from caller ID.
*   In your e-commerce platform, new buyers become customers.
*   ...And in your CRM, your customers should consolidate all of this information into a single view.

Through PieSync you can, and you should tweak the sync so that not only contacts get synced, but you also respect the segmentation, tags, groups, categories, custom attributes, subscription status, ... of the apps that the contacts live in. In a PieSync rule, you can choose to add a filter and add actions to syncs. More information on conditions and actions [here](/help/features/conditions-and-actions/).  
**Where can I set up a new rule?** Simply click "+ Add another rule ..." on the left, underneath the existing ones:  

![](//images.ctfassets.net/f2ysq090txql/799j5xgkM9zh9i5lRox5e3/b2b5cb9330c60733ad57cbc424d857f7/screenshot-2019-04-12-at-15-15-45.png)

  
<InfoBox>_Have more questions about Rules? Just drop us a line at [support@piesync.com](mailto:support@piesync.com), happy to help!_   
**Don't forget to read our [blog](http://blog.piesync.com/) for the latest in productivity, apps, and technology!**</InfoBox>

  With the IF/THEN rules you can dictate which contacts need to sync. Henceforth, we shall refer to these IF/THEN sentences as rules. By default PieSync will set you up with a two-way and all-to-all sync, which consists of a rule for each app with...

Connection Rules: IF/THEN

### Why are my contacts not syncing? Why is my sync not working? Why am I seeing duplicates?

These are questions you might have if you see anything unusual happen with your contacts or sync(s) and you're wondering 'why?' Our troubleshooting tips below can provide an answer to questions about commonly encountered events and might help you fix them. 

<InfoBox>_If troubleshooting does not clarify your experience, we require temporary access to your app-data to investigate why your contacts are not syncing. Email support@piesync.com & provide the email address of one or two contacts that aren't syncing correctly._</InfoBox>

<TipBox>We're working hard on the PieSync Health Dashboard, this is on our 2019 roadmap and will make the below-described troubleshooting more transparent.</TipBox>

## 1\. Do your contacts have an email address? Is [_Avoid Duplicates_](/help/features/avoid-duplicates/) enabled? 

The algorithm of PieSync is based on the allocation of an existing email address. **Contacts will only be synced if an email address is included**.  With some applications this setting is mandatory, with others you're able to determine yourself. When mandatory, you can always contact us, we just want to make sure you are aware of possible implications before doing so. 

![](//images.ctfassets.net/f2ysq090txql/7x6rwssht5hF7B7SKf0D4X/aff2aa9c6c64a889d04fd9ed61b54a07/screen-shot-2017-11-03-at-14-55-36.png)

![](//images.ctfassets.net/f2ysq090txql/3TyOE6g50RnxCe3G7yOVAm/8c73d094d1cac2bb35f4f700cc6f258f/screen-shot-2017-11-10-at-10-34-45.png)

## 2. Are your contacts part of the rules (IF/THEN) you have configured?

Through PieSync you can and you should tweak the sync so that not only contacts get synced, but you also respect the segmentation, tags, groups, categories, custom attributes, subscription status, ... of the apps that the contacts live in. In a PieSync [rule](/help/features/multiple-rules/), you can choose to add a filter, and add actions to syncs. 

**It’s crucial to know the distinction between adding additional filters (IF) within a rule (AND) or creating a completely new rule per filter (IF).**

For each filter you add within a rule, you establish an extra **requirement**. A contact will only be synced when it fulfills **ALL** of the requirements. In the example below, a contact needs to have the status "Subscribed" **and** "Cleaned" **and** "Pending" in order for it to be synced.

![](//images.ctfassets.net/f2ysq090txql/5vyxyQhlttGlTXiC8saM3z/12b710313d7c152989615815fadb720f/shot-2.png)

Creating separate rules for each filter allows you to sync contacts that are in **ANY** of the filters (IF) you choose rather than having to be present in **ALL** before it will sync. 

![](//images.ctfassets.net/f2ysq090txql/5WvhkgaiTMPJ3TgUqZIY1S/d5e82e92ade83788e7b2640bf2347cf9/shot-1.png)

<WarningBox>Disclaimer: This is a fabricated example, solely used for educational purposes.</WarningBox>

## 3. Does PieSync still have access to your app-accounts? _(Access Revoked/Authentication Failed)_?

Due to long inactivity, changes in your login details or changes in the API restrictions, it might happen that PieSync loses access to your applications. 

Rauthenticate your account via the **red banner**, visible on your configuration page. 

1.  Log in on the [**PieSync platform**](https://app.piesync.com/signin)
2.  Click the **"connections" tab** and access your connection
3.  Click the **configuration** button at the top right of the page.

<InfoBox>More information about _(re-)authorisation_ can be found [here](/help/faq/why-am-i-seeing-authentication-failed/).</InfoBox>

## 4. Do your contacts meet the app-requirements?

Whether or not a contact is being kept in sync between two applications can also be dependent on the requirements of the applications itself. 

The example below shows a contact in _Capsule CRM_ which can only be created after providing a first or last name. Therefore, a contact will not be synced if this requirement is not met. Another example, for instance: a contact in HubSpot be created with only an email address. In a connection with Capsule, this contact will not be synced to Capsule until the first or last name is added there first. 

![](//images.ctfassets.net/f2ysq090txql/50tMU7ZgLZKtsLy7L4zjuA/64151c3a1e0f2ba0d98b4f9ddd6e5673/gif-2.gif)

<TipBox>Some applications have strict requirements such as e.g [EZ texting](/help/connector-apps/eztexting/), [Drip](/help/connector-apps/drip/),…</TipBox>

## 5. Am I trying to sync CONTACT/LEADS information?

We only sync **contact & leads** information. 

Depending on the apps you have connected, you might be looking for data that you believe to be part of the contacts in that app. However, it might actually be part of a different entity we don't sync (just) yet. In the example below, we only sync **People & Leads.**

![](//images.ctfassets.net/f2ysq090txql/d1LMgPyflYaAE4X6Zg6Yq/5fd83e02ee48257da8f5bb79762ff642/screen-shot-2017-11-10-at-15-09-04.png)

<TipBox>More in-depth info about syncing Leads can be found [here](/help/faq/syncing-leads/).</TipBox>

<TipBox>More in-depth info about our Company to Company sync can be found [here](/help/faq/can-i-sync-company-account-information/).</TipBox>

## 6. Is there a third party or native integration _in parallel with PieSync_ active?

Before activating PieSync, you want to make sure there is no other native or third-party integration **running in parallel**. Some applications come with their own integrations. Other/parallel integration(s) will also have access to your data and the ability to manipulate which could cause large numbers of duplicates & loops. That's why we ask you to use PieSync and nothing else to keep your data in sync between two apps. 

<InfoBox>A native integration differs tremendously from PieSync. More info can be found [here](/help/faq/why-prefer-pie-sync-over-other-native-free-integrations/).</InfoBox>

## 7. Did you make an adjustment to a field that is mapped?

It's important to check the default field mappings between a connection. If you update a contact field in application A and you notice it's not syncing to application B, this field might not be part of the default mappings. In some cases, this can be solved by adding a [custom field mapping](/help/features/new-customizable-field-mapping/).  

## 8. Case sensitivity

The screenshot below shows an example of a rule to create segmentation based on the Company Name.   

The value of these fields are **case sensitive**. This means that contacts with the allocated "**p**ie**s**ync" name in QuickBooks will **NOT** sync.   

![](//images.ctfassets.net/f2ysq090txql/5WbSGeLu6yaQWWl4dvgPJu/84c8ec88e477f72ec245975cdc5c2104/screen-shot-2018-09-13-at-15-45-59.png)

#### Make sure the distinction between upper-and-lower cases is correct!

## 9. Are you experiencing Duplicates? This might be why.

*   [I am experiencing a small number of duplicates](/help/faq/how-come-i-am-getting-a-small-amount-of-duplicates/)
*   [I am experiencing a large number of duplicates](/help/faq/why-am-i-getting-a-large-number-of-duplicates/)

## 10. Still experiencing issues? 

If the aforementioned topics are not helping, it's always possible to reach out to us. 

<InfoBox>For us to investigate this issue further, we would require temporary access to your app data. If this is ok for you, would you mind providing us with the ID (Copy URL when opening the contact) or email address of a contact that is not syncing? Please send us an email via **support@piesync.com**.</InfoBox>

Why are my contacts not syncing? Why is my sync not working? Why am I seeing duplicates?  These are questions you might have if you see anything unusual happen with your contacts or sync(s) and you're wondering 'why?' Our troubleshooting tips belo...

Troubleshooting - My contacts are not syncing

1CRM-logo-box

1CRM

logo-3dcart

3dcart

act!

Act! 365

actpremium

Act! Premium

apps.41598.37145b45-309a-44d2-8a3a-8ef5dd923138.b03415bf-0d24-4925-924c-d111c87e195a.e4b8a9d0-ed9e-44f4-81d3-524fbe3257b6

Actionstep

activecampaign

ActiveCampaign

activedemand

ActiveDEMAND

activetrail-1502192111-logo

ActiveTrail

Acumatica

Acumatica CRM

agendor_logo

Agendor

agilecrm

Agile CRM

aircall-icon@2x (1)

Aircall

allclients

AllClients

amocrm

amoCRM

apollo.io logo 

Apollo

apptivo

Apptivo

aproplan

Aproplan

apto_logo

Apto

Aritic-Logo

Aritic PinPoint

Aritic Sales CRM

AT & T

AT&T Office@Hand

autoklose logo png 

Autoklose

autopilot

Autopilot

aweber

AWeber

benchmark

Benchmark

bexio

bigcommerce

BigCommerce

bigcontacts

BigContacts

bill.com logo

Bill.com

bitrix

Bitrix24 CRM

bombbomb

BombBomb

bookeo

Bookeo

boomtown

BoomTown

Brivity CRM

btcloudphone

BT Cloud Phone

bubble_piesync

Bubble

bullhorn

Bullhorn

campaignmonitor

Campaign Monitor

campaigner

Campaigner

capsulecrm

Capsule

cats-logo

CATS

chargebee

Chargebee

Chime-Logo (1) (1)

Chime

cin7_logo_piesync

Cin7

cxsocial

Clarabridge Engage

Classy-icon-coral

Classy

click-send_logo_piesync

ClickSend

clio

Clio Manage

closeio

Close

companyHub

CompanyHub

connectwisemanage

ConnectWise Manage

constantcontact

Constant Contact

Contactlab Marketing Cloud

Contacts+ Logo Mark (1)

Contacts+

contactually

Contactually

convergehub

ConvergeHub

Seva (formerly ConvertKit)

ConvertKit

Copper-icon-circle-pink

Copper

bpmonline

Creatio

Crisp

currentrms

Current RMS

datavalidation

DataValidation

daylite

Daylite

d-logo-L-transparent

Debitoor

Delivra

desk

Desk

logo-digitaleo

Digitaleo

DD-roundel-512x512

dotdigital Engagement Cloud

dotloop

Dotloop

drift_logo

Drift

drip

Drip

dubb-logo-full

Dubb

easybill

EasyBill

efficycrm

Efficy CRM

Elastic Email

emma

Emma

icon-256x256 (1)

EngageBay CRM

Start syncing Direct Mail for Mac and 123FormBuilder two-way

Discover all our 243 apps

Accurate & real-time data

Save time

Easy & Secure

Free Trial

Help Articles related to syncing Direct Mail for Mac & 123FormBuilder