---
title: Timegrip integration
description: Learn how to set up an integration between Ziik and Timegrip to automate user creation, updating, and deletion.
---

[Skip to content](https://help.ziik.io/how-to-synchronise-users-from-timegrip#main-content)

[![Ziik\_White.png](https://help.ziik.io/hs-fs/hubfs/Ziik_White.png?height=45&name=Ziik_White.png)](https://help.ziik.io/?hsLang=en)

Open main navigation

Close main navigation

 Advice and answers from the Ziik team

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.ziik.io/?hsLang=en)
2. [Site Admin Settings](https://help.ziik.io/site-admin-settings?hsLang=en)
3. [Integrations](https://help.ziik.io/site-admin-settings?hsLang=en#integrations)

# Timegrip integration

## Learn how to set up an integration with Timegrip to automate user creation, updating, and deletion.

### About the integration

The integration with Timegrip helps you automate creation, updating, and deletion of users in Ziik.

### Requirements in Ziik

You need to be a[platform admin](https://help.ziik.io/what-you-can-do-as-admin?hsLang=en) to configure integrations in Ziik. 

### How to set the integration up

1. On desktop, click the **Admin cogwheel** and then **Integrations**
2. Click **Create integration**
3. Choose **Timegrip**

### How to configure the integration

#### In the form that appears:

Give the integration a **Name** and provide the necessary **API information**

#### Defaults: (Defaults apply only to new users and can be edited by users in their personal settings)

**Show email**  
*Enabled* - users’ emails are visible to everyone on their profile.   
*Disabled* - only those with permission to edit a user can view their email.

**Show birthday***Enabled* -  the users’ birthdays (if set) can be viewed by others in the calendar view.  
*Disabled* - the users’ birthdays cannot be viewed by others in the calendar view.

**Show phone**  
*Enabled* - users’ phone numbers are visible to everyone on their profile.   
*Disabled* - only those with permission to edit a user can view their phone number.

**Show alternative phone**  
*Enabled* - users’ alternative phone numbers are visible to everyone on their profile.   
*Disabled* - only those with permission to edit a user can view their alternative phone number.

**Default language-** What language should the Ziik platform be set to for new users?

#### Synchronisation policies

**Hijack Policy**

When a user already existing in Ziik has the same email address as one found in Timegrip, decide how the integration should behave:

- *Update* (overwrite) the Ziik profile with information from Timegrip, or
- *Ignore* users that were not created through this integration.

**Ignore users with incomplete memberships**

Users with incomplete memberships are *users with a Department or Role in Timegrip without a matching Unit or Role in Ziik. *

*Enabled* - Users with incomplete memberships *will not be synchronised to Ziik*. If a user with a complete unit & role membership has already been synchronised to Ziik, and is then changed in Timegrip, so that their membership becomes incomplete, the user will lose their membership in Ziik. Users with incomplete memberships can in Ziik be found by navigating to *Admin Panel -\> User Administration -\> Unassigned.*

*Disabled -* Users will be created and updated in Ziik despite having an incomplete membership. Users with incomplete memberships can in Ziik be found by navigating to *Admin Panel -\> User Administration -\> Unassigned.*

**Send welcome emails***Enabled* - users will automatically be invited to sign up and login as soon as they are created in Ziik  
*Disabled* - users will not automatically be invited. Someone must manually [send welcome emails to new users](https://help.ziik.io/inviting-users-to-sign-in?hsLang=en#batch).

![](https://help.ziik.io/hs-fs/hubfs/image-png-Nov-28-2025-01-22-27-2157-PM.png?width=632&height=1114&name=image-png-Nov-28-2025-01-22-27-2157-PM.png)

 

### **How the integration works**

#### Importing users from Timegrip

New users created in Timegrip will be synchronised to Ziik if they:

- Have a first name
- Have a last name
- Have an email
- If multiple users have the same email address within Timegrip, only the first one will be imported and the second one will be ignored

If “Ignore unassignable” is enabled for the integration, a valid membership is required to import a user. If we weren’t able to assign a complete membership to the user based on their properties in Timegrip, the user will be ignored and only imported once all requirements have been met.

Synchronization of users’ Unit & Role memberships:

- All unit & role memberships created by the integration, will be linked
- If you manually add a role to a unit membership that was created through the integration, the integration will not overwrite the change.
- If you remove a role in a membership that was created through the integration, the role will not be restored/replaced by the integration

- If a membership created through the integration is updated in Timegrip, placing a user in a different unit, the new unit membership will replace the old one in Ziik
- If a membership created through the integration is updated in Timegrip, placing a user in a unit that they already have been assigned to manually in Ziik, the membership will be linked and any additional roles will be added to the existing membership
- If a membership created through the integration has been updated in Timegrip, changing a user's set of roles, only the roles previously created by the integration are subject to removal. Any roles assigned manually in Ziik need to be deleted manually.
- If a linked unit membership is manually deleted in Ziik, the membership will automatically be recreated the next time the integration runs.
- If a linked user, with only manually created memberships, is updated such that the user should be placed in another unit, an additional membership will be created with the assigned roles.
- If roles in a membership that was created through the integration are changed manually in Ziik, the integration will not overwrite the changes

#### Updating users from Timegrip

#### When a user is updated in Timegrip, the user is also updated in Ziik. However, users not considered valid, will be deleted. Users are considered invalid when they’re missing first name, last name, or email.

#### Delete users in Timegrip

When users are deleted in Timegrip, the user is deactivated in Ziik and marked to be deleted in 90 days. These users can be viewed in Ziik by navigating to *Admin Panel -\> User Administration -\> Deactivated.*

 

- [Getting Started](https://help.ziik.io/getting-started?hsLang=en#main-content)

    - [Introduction to Ziik](https://help.ziik.io/getting-started?hsLang=en#introduction-to-ziik)
    - [Getting-Started in 5 Steps](https://help.ziik.io/getting-started?hsLang=en#getting-started-in-5-steps)
- [Been invited to join Ziik?](https://help.ziik.io/been-invited-to-join-ziik?hsLang=en#main-content)

    - [Login](https://help.ziik.io/been-invited-to-join-ziik?hsLang=en#login)
    - [Profile setup and personal settings](https://help.ziik.io/been-invited-to-join-ziik?hsLang=en#profile-setup-and-personal-settings)
- [How to use Ziik](https://help.ziik.io/how-to-use-ziik?hsLang=en)
- [Organisation & Permissions](https://help.ziik.io/organisation-permissions?hsLang=en#main-content)

    - [About Permissions](https://help.ziik.io/organisation-permissions?hsLang=en#about-permissions)
    - [Manage Units & Roles](https://help.ziik.io/organisation-permissions?hsLang=en#manage-units-roles)
    - [Manage Users](https://help.ziik.io/organisation-permissions?hsLang=en#manage-users)
    - [Site Admin](https://help.ziik.io/organisation-permissions?hsLang=en#site-admin)
- [Site Admin Settings](https://help.ziik.io/site-admin-settings?hsLang=en#main-content)

    - [Admin Panel](https://help.ziik.io/site-admin-settings?hsLang=en#admin-panel)
    - [Handling Billing and Invoices](https://help.ziik.io/site-admin-settings?hsLang=en#handling-billing-and-invoices)
    - [Integrations](https://help.ziik.io/site-admin-settings?hsLang=en#integrations)
- [FAQ](https://help.ziik.io/faq?hsLang=en#main-content)

    - [Common questions](https://help.ziik.io/faq?hsLang=en#common-questions)
    - [Troubleshooting](https://help.ziik.io/faq?hsLang=en#troubleshooting)

## Ziik

The social intranet software                                                **[Talk to Support?](https://www.ziik.io/support)<https://www.ziik.io/support>**

Copyright © 2025, Ziik