> ## Documentation Index
> Fetch the complete documentation index at: https://absentify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating timeghost with absentify

> Connect timeghost with absentify to sync absences into time tracking, reduce manual entry, and produce accurate timesheets and HR reports automatically.

Integrating **timeghost** with **absentify** ensures seamless time tracking and absence management for employees. This integration reduces manual tasks, improves reporting accuracy, and streamlines workflows.

<iframe src="https://demo.arcade.software/CdVUanCTgaHLItmAQG2U?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=false" title="Managing users in absentify" frameborder="0" loading="lazy" webkitallowfullscreen mozallowfullscreen allowfullscreen allow="clipboard-write" className="responsive-iframe" />

## Benefits of the integration

* **Enhanced accuracy**: Automatic data synchronization minimizes manual errors.
* **Streamlined processes**: Time tracking and absence management are automated for efficiency.
* **Improved reporting**: Combined data provides better insights for analysis and reporting.

***

## Preparing for the integration

If you signed up with email (rather than Microsoft 365), you must confirm your email address before you can connect timeghost.

### 1. Set your time zone

Make sure the time zones in timeghost and absentify are aligned to avoid inconsistencies in absences and working hours:

1. In **timeghost**, select your profile photo in the top right, select **My Profile** from the dropdown, and set the time zone to match the settings in absentify.
2. In **absentify**, navigate to **Settings > Users > Default User Settings** and verify that the [company time zone](/docs/en/roles/hr_admins/settings/users/manage_users#default-user-settings) is set correctly.

### 2. Set up default business hours

Ensure each user’s schedule in timeghost matches their schedule in absentify. For both systems, we recommend defining standard business hours at the workspace level and applying them to users by default.

1. In **timeghost**, go to **Settings > Working hours > Schedule** and configure your standard business hours.
2. In **absentify**, refer to [this guide](/docs/en/roles/hr_admins/settings/general/general#business-hours) to adjust company-wide business hours.

### 3. Add users and adjust their schedule if necessary

Make sure all users whose absences should be synchronized from absentify are also added to timeghost:

1. In **timeghost**, go to **Workspace > Team > Invite user**. When adding a new user, the default business hours schedule configured in the previous step will be available.

<Tip>
  To activate it, go to **Settings > Users**, select the pencil icon next to the user, open the **Schedule** tab, and activate the schedule. The values are taken from the default workspace settings. Adjust the schedule if needed, for example for part-time users.
</Tip>

2. In **absentify**, follow the guide for adding users and refer to [Setting up a user’s schedule](/docs/en/roles/hr_admins/settings/users/edit/schedule) for detailed instructions.

***

## Setting up the integration

<Steps>
  <Step title="Step 1: Access your absentify account">
    Log into your absentify account [here](https://absentify.com/) and ensure you have admin rights.
  </Step>

  <Step title="Step 2: Navigate to integrations">
    Go to the **Integrations** section in the absentify dashboard to manage all third-party connections.
  </Step>

  <Step title="Step 3: Select timeghost integration">
    Find and select the **timeghost** integration option in the list.
  </Step>

  <Step title="Step 4: Authorize the connection">
    1. Select **Configuration > Add new timeghost synchronization**.
    2. Authorize the connection between absentify and timeghost. You can create multiple synchronizations for different workspaces or departments.
  </Step>

  <Step title="Step 5: Customize the connection">
    1. Name your connection.
    2. Select the **departments** to synchronize. The selected departments apply to all users within those departments. For all included users, approved absences will be automatically created in timeghost and recorded as absence time.
    3. Select the **leave types** to synchronize. The synchronization applies to both individual leave requests and recurring leave requests. Absences of invisible managers are not synced into department timeghost workspaces visible to members.

    <Info>
      Please note that for recurring leave requests, only absences that have already started will be synchronized. Future occurrences are not synced in advance. For example, if you set up a recurring absence for every Monday, each occurrence will only be synchronized on the respective Monday when it takes place. Future dates are not transferred beforehand, as they could still be modified, canceled, or deleted in absentify.
    </Info>
  </Step>

  <Step title="Step 6: Add the API key">
    1. In **timeghost**, go to **My Profile** and copy the API key.
    2. Paste the API key into the absentify configuration and select **Next**.

    <Warning>
      **Important:** If you refresh or generate a new API key in your timeghost workspace, the connection between absentify and timeghost will be interrupted, and absences will stop syncing. There is no need to create a new integration.
      Instead, go to Settings > Integrations > timeghost > Edit in absentify, and simply replace the old key with the new one. This will restore the connection and resume syncing.
    </Warning>
  </Step>

  <Step title="Step 7: Configure settings">
    1. Define how absences from absentify should sync with timeghost.
    2. Specify the timeghost workspace and whether to include past absences.
  </Step>

  <Step title="Step 8: Test the integration">
    Test the integration to ensure data synchronization works correctly. Check if absences from absentify are accurately reflected in timeghost.

    <Info>
      For detailed visibility into what was synced, when, and how, you can also review the [Microsoft sync logs](/docs/en/roles/hr_admins/settings/microsoft#microsoft-sync-logs).
    </Info>
  </Step>
</Steps>

<Warning>
  Please note that public holidays stored in absentify are not transferred to timeghost during synchronization.
  Public holidays must be maintained separately in timeghost to ensure accurate time tracking and reporting.
</Warning>

***

## Managing the integration

### Manage deleted absences

If a leave request that has already been synchronized is deleted in absentify, the corresponding entry in timeghost will also be automatically deleted.

<Check>
  This ensures that both systems remain fully aligned and prevents outdated or incorrect entries from remaining in timeghost.
</Check>

### Delete a timeghost connection

1. Navigate to **Settings > Integrations**.
2. Select the trash icon next to the connection you want to remove.
3. Select whether you want to keep or delete all previously synchronized entries before confirming.
   Make sure to select the correct option as this cannot be undone. If you are unsure, refer to our best practices below:

| Use Case                                                                                       | Best practice                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| If you want to stop future synchronization but keep all previously synced entries in timeghost | Select the option to keep all past syncs before deleting the integration. This ensures that historical entries remain in timeghost while no new data is transferred.                                                                                                                                                                                                                                                                                      |
| If you want to completely reset the integration                                                | Select the option to delete all past synced entries. When setting up the integration again, make sure to enable sync all past absences. This ensures that all previous absences are newly synchronized and that automatic updates between absentify and timeghost continue to work properly. This is especially important if a past absence is deleted in absentify. With a fully re-synced connection, the deletion will also be reflected in timeghost. |
