Link Search Menu Expand Document

Getting started

  1. Sign up
  2. Set up
    1. Sync your current directories
    2. Combine users into groups
    3. Search through the contact details
    4. Optional: Sync a group to Azure AD
  3. Scenarios
    1. Combine directories within your company
    2. Combine directories over multiple companies
  4. Examples

Sign up

Continue to set up your Federated Directory if you already signed up before.

Before you start using Federated Directory, you have to sign up. It is easy and free.


Two ways to sign up:

  1. Sign up with your Google or Microsoft account.
  2. Sign up manually.

During your sign up you will need to provide this information:

Input Description
Short company name Must be between 2 and 40 characters and can contain only letters, numbers, dashes - and underscores _. It will be a part of your company-specific URL of your Federated Directory:<your-short-company-name>.
Your name The display name that will be used to create your first user account.
Email address Please make sure it is valid, since we send all the information you need to get started to this email address.

Only finalize the sign-up process after you have read and agreed to our terms of service.

Set up

The setup of your Federated Directory consists out of a few steps.

Setup your Federated Directory in 3 steps

  1. Sync your current directories
  2. Combine users into groups
  3. Search through the contact details
  4. Optional: Sync a group to Azure AD

Sync your current directories

After you sign up, your Federated Directory will only contain your user account. There are multiple ways to import the contact data of your current corporate address book. You can create the users manually or upload a CSV file but you can also sync the data directly from:

Any other source can be integrated with our User API (SCIM compliant).


Combine users into groups

A user can only search through the contact data of those users that are in the same group. A group can contain users from multiple companies and/or directories.

Your company contains one group after sign up: the “all users” group. By default, this group will contain all the users within your company. This makes sure all the users in your company are able to find each other. You can remove this group if required.

There are two ways you can add users to a group:

  1. Invite them
  2. Automatically

Invite them

After you create a group you can invite other to that group by inviting them. Invited users will receive an email that they can accept.

This is the only way you can add a user from another company to your group. Once that user has accepted your invite, you can make it a ‘group owner’ as well. At that point it can add more users from its company.


When you are a group owner and an admin within your company you can add users to a group automatically with a ‘smart filter’. This ‘smart filter’ adds all the users to this group that meets this specific filter. For example users that are:

  • Part of a division or department
  • Have been synced from a specific directory


Search across companies

You and your colleagues can now login and search through all the directories at the same time. This can be done, through our web based application (PWA) or through our Microsoft Outlook add-in.

Optional: Sync a group to Azure AD

This has not been released yet. We are working on a way to sync all the users from a group in your Federated Directory back to an Azure AD. This would make it possible to find the contact data of the users in this group, directly in the Office apps your employees already use. Like Teams & Outlook.


Combine directories within your company

Imagine you have one company that uses two different cloud services like Google Workspace and Azure AD. Or you have two daughter companies with separate Azure AD’s and you would like to make employees of both services searchable at one place.

One company, different providers
Two child companies

In this situation, the most suitable option for you, would be to create 2 separate directories inside 1 Federated Directory tenant and provision employees into them.

Two child companies

As soon as both directories are filled with employees, they can login to Federated Directory and start search each other.

For more information :

  • About directories refer to here.
  • About provisioning from Google Workspace refer to here.
  • About provisioning from Azure AD refer to here.

Combine directories over multiple companies

If you want to search through the directories of other companies, you need to create cross-company group.

Federated Directory Overview

Create a cross-company group in a few steps:

  1. Ensure that the other companies have signed up for Federated Directory as well
  2. Create a group
  3. If you want some of your employees to be visible to other companies, add them to this group
  4. Invite employees of the other companies to this group
  5. Optionally: make some of the users of these companies ‘group owners’. This way they can add users from their company to this group directly.

You can skip step 2 and use an existing default group; however, you should bear in mind that the default group created during the sign up process includes all the users within your Federated Directory.