---
availability: INSTALLABLE
description: A plugin that allows you to lookup the time entry codes in order to check
  in.
installation_asset_uuid: ce548da4-8dbb-4255-94d5-1babd7cb4616
name: View Check-In Time Entry Code
purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EWhat+are+my+eligible+time+entry+codes+for+today%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+can+fetch+the+eligible+time+entry+codes+for+you+in+Workday+for+today%2C+March+7%2C+2025.%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+eligible+time+entry+codes+for+you%3A%3C%2Fp%3E%5Cn%3Cul%3E%5Cn++%3Cli%3EREGULAR%3A+Regular+Hours%3C%2Fli%3E%5Cn++%3Cli%3EOVERTIME%3A+Overtime+Hours%3C%2Fli%3E%5Cn++%3Cli%3EPROJECT_IN_OUT%3A+Project+Time%3C%2Fli%3E%5Cn++%3Cli%3ESICK%3A+Sick+Time%3C%2Fli%3E%5Cn%3C%2Ful%3E%22%7D%2C%7B%22richText%22%3A%22%3Cp%3E%3Cstrong%3EDo+you+want+to+check-in+for+any+of+the+above+time+entry+codes%3F%3C%2Fstrong%3E%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Yes%22%7D%2C%7B%22buttonText%22%3A%22No%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D
solution_tags:
- HR - Other
- HR - Time & Absence
systems:
- workday
---

# **Introduction:**

The **View Check-In Time Entry Code** plugin provides instant access to Workday time tracking codes through the Moveworks AI Assistant. Employees and managers can quickly lookup valid time codes, categories, and project identifiers - enabling accurate time entry without switching systems.

This guide outlines the simple setup to enable time code lookups in minutes.

# **Prerequisites :**

- Access to Agent Studio

# **What are we building?**

### **Agent Design**

This [purple chat]( https://developer.moveworks.com/creator-studio/developer-tools/purple-chat/?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EWhat+are+my+eligible+time+entry+codes+for+today%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+can+fetch+the+eligible+time+entry+codes+for+you+in+Workday+for+today%2C+March+7%2C+2025.%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+eligible+time+entry+codes+for+you%3A%3C%2Fp%3E%5Cn%3Cul%3E%5Cn++%3Cli%3EREGULAR%3A+Regular+Hours%3C%2Fli%3E%5Cn++%3Cli%3EOVERTIME%3A+Overtime+Hours%3C%2Fli%3E%5Cn++%3Cli%3EPROJECT_IN_OUT%3A+Project+Time%3C%2Fli%3E%5Cn++%3Cli%3ESICK%3A+Sick+Time%3C%2Fli%3E%5Cn%3C%2Ful%3E%22%7D%2C%7B%22richText%22%3A%22%3Cp%3E%3Cstrong%3EDo+you+want+to+check-in+for+any+of+the+above+time+entry+codes%3F%3C%2Fstrong%3E%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Yes%22%7D%2C%7B%22buttonText%22%3A%22No%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build.

# **Installation Steps**

While you can create a connector during plugin installation, we recommend setting up the connector in **Agent Studio** beforehand to simplify the process. Please follow our [**Workday Connector Guide**](https://developer.moveworks.com/marketplace/package/?id=workday&hist=home%2Cbrws#how-to-implement) for detailed instructions. Once completed, proceed to install the plugin and complete the setup efficiently.

For this plugin, ensure the Workday integration system user has the following permissions:

## **Required Permissions:**

- `View access`to worker data : Time Tracking
- `Get access`to worker data : Time Codes

> Note: Ensure Workday domain security policies grant API access to these functions.
> 

**Tenant Configuration:**

All Workday API endpoints in this plugin use **TENANT** as a placeholder. After installation, replace **TENANT** in the action definitions with your actual Workday tenant name.

To find your tenant name:

- Log into Workday.
- Check the URL in your browser — the tenant name appears after `workday.com/`, e.g.: [https://impl.workday.com/**your_tenant**/...](https://impl.workday.com/**your_tenant**/...)
    

Make sure to update this across all actions that reference the Workday API.

After configuring the connector and updating your tenant, refer to our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for more details on completing the setup.

# **Appendix**

## **API #1: GET Worker ID**

The Get Worker Id API uses WQL to retrieve the worker ID.

```bash
curl --request POST \
curl --location 'https://<DOMAIN>.myworkday.com/api/wql/v1/<TENANT>/data?offset=0&limit=1' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
    "query": "SELECT workdayID, fullName,businessTitle, email_PrimaryWorkOrPrimaryHome,employeeID FROM allWorkers WHERE email_PrimaryWorkOrPrimaryHome = '{{email_PrimaryWorkOrPrimaryHome}}'"
}
'

```

**Request Body Fields :**

- email(string) – The email address of the user whose worker id and timezone want to retrieve.

## **API #2: Get TimeEntryCode**

The **Get TimeEntryCode** API retrieves a worker's TimeEntryCode based on their Worker ID from Workday. This API is essential for fetching the worker's time entry codes for a specified date and in/out code.

```bash
curl --location 'https://<YOUR_DOMAIN>/api/timeTracking/v3/<INSTANCE_ID>/values/timeTypes/timeEntryCodes?date=<DATE>&inOutCodeOnly=true&worker=<WORKER_ID>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```

**Query Parameters :**

- WORKER_ID(string) – The worker id of the user whose even type id want to view.
- DATE(string) – The random date.