All Collections
Best Practice Guides
HRIS
Migrating from Teams to Groups
Migrating from Teams to Groups

How to migrate from using the Teams Common Model to the Groups Common Model

Michelle Krameisen avatar
Written by Michelle Krameisen
Updated over a week ago

Overview

Historically Merge mapped the Teams Common Model to represent an Employee's subdivision in a company, usually a department. Each employee was grouped into one specific Team.

Deprecation of Teams

We found that the Groups Common Model is more flexible and comprehensive, as different API providers represent an Employee's Team, Department, or Business Unit in varying ways. Groups will have all of the same capabilities as Teams going forward and more.

Merge will no longer support the Teams common model after April 20th, 2023. This means we will not add any improvements or support any bug fixes related to Teams. We strongly recommend using Groups as it has the same capabilities as Teams and is more comprehensive.

Groups Common Model

A Group represents any subset of employees. The Groups model will contain the full set of all subdivisions within a company, which can include cost centers, pay groups, teams, departments, and many more.

Mapping between Teams and Groups

For each integration, you can use the table below to access the existing Team from the new Groups model.

Integration

Group that maps to current Team

ADP Workforce Now

type = DEPARTMENT

AlexisHR

type = DEPARTMENT

BambooHR

type = DEPARTMENT

Breathe

type = DEPARTMENT

Ceridian Dayforce

type = On-Site Department

CharlieHR

type = TEAM

Charthop

type = DEPARTMENT

Deel

type = TEAM

Factorial

type = TEAM

Freshteam

type - TEAM

Gusto

type = DEPARTMENT

HR Cloud

type = DEPARTMENT

HR Partner

type = DEPARTMENT

Hibob

type = DEPARTMENT

Humaans

type = TEAM

Keka

type = 7

Justworks

type = DEPARTMENT

Lucca

type = DEPARTMENT

Namely

type = DEPARTMENT

Officient

type = TEAM

Paychex

type = Level 1

Paycor

type = DEPARTMENT

Paylocity

Add query parameter, "show_enum_origins = type" to show the raw value of the Group name.

type = cost_center2

PeopleHR

type = DEPARTMENT

Personio

type = TEAM

SAP SuccessFactors

type = DEPARTMENT

Sage HR

type = TEAM

Sapling

type = DEPARTMENT

TriNet

type = DEPARTMENT

UKG Pro

type = OrgLevel2

UKG Ready

Add query parameter, "show_enum_origins = type" to show the raw value of the Group type.

type = 2

Workday

type = DIVISION

Zenefits

type = DEPARTMENT

Please reach out to your Engagement Manager or [email protected] with any questions!

Did this answer your question?