Welcome to Seraphex Support

All of our public knowledge, in one place.

KDesk Contact Integration and Sync

Contact Sync Contact Sync brings people from your organization into KDesk as contacts. It helps keep names, email addresses, phone numbers, company details, and other profile information up to date so your team can work from one contact list. Contact Sync is one-way into KDesk. It updates contact records in…

Overlay Image Overlay Image

Contact Sync

Contact Sync brings people from your organization into KDesk as contacts. It helps keep names, email addresses, phone numbers, company details, and other profile information up to date so your team can work from one contact list.

Contact Sync is one-way into KDesk. It updates contact records in KDesk, but it does not change anything in your source directory.

How to Access Contact Sync

In the KDesk App, open the Team navigation and select Contact Sync. If you do not see it, contact sync may be turned off for the workspace or your account may not have permission to manage it. This page is only available to team members, not contact users.

What the Page Includes

AreaWhat it does
Search connectionsFilters the list by connection name, source, or status.
Run allRefreshes every saved connection.
New connectionStarts a new contact sync setup.
Connection cardShows the connection name, source, status, and recent activity.
Connection actionsEach card includes options to edit, view activity, run, or delete.
Sync logs raw exportDownloads the full raw log payload for a run as a plain-text file for troubleshooting.

A saved connection appears as Enabled when it is active, or Draft when it has been saved but not turned on yet.

Connection Setup

When you create a connection, choose the source your organization uses, give the connection a clear name, and add a short description if helpful. Then choose which people should be included and which contact fields should be filled in KDesk.

Use the scope settings to limit which people can be imported. This is useful when you only want KDesk to sync a department, region, or other subset of your organization.

Scope modeHow it works
ListIncludes only people who match the allowed groups or categories you choose.
PatternUses a matching rule to include people from a specific directory segment.

The mapping area lets you decide which KDesk contact fields get filled from your source directory. Use it to keep the most important details in sync, such as names, email addresses, phone numbers, company information, addresses, notes, and portal-related preferences.

Field groupWhat it covers
Identity and profileName, email, company, job title, division, and notes
CommunicationEmail addresses and phone numbers
AddressStreet address, city, region, postal code, and country
Access and notificationsPortal access and email notification preferences

If a connection is already working, you usually do not need to change the advanced settings. Those are normally handled by the person who set up the source connection.

Running Sync and Reviewing Results

Use Run on a connection to refresh just that one source, or Run all to refresh every connection. Open Logs to review recent sync activity and check whether a run completed successfully.

If the wrong people are being imported, first check the scope settings, then review the field mapping. Save your changes and run the connection again to confirm the result.

How Contact Sync Helps the Rest of KDesk

Once contacts are imported, they appear in the Contacts directory and can be used for tickets, notifications, forms, and portal access according to the settings you choose. Contact Sync is designed to keep the directory current without requiring manual updates for every person.

Rate this article?

Related Post

KDesk Logging and Auditing

This article explains the current Logs page in KDesk, i...

KDesk Email Integration and Sync

Email Intake and Sync Email Intake turns incoming em...

KDesk Team Management

This article explains the current Team Settings page in...