# TimeCamp integration

> Time tracking: time entries, timers, projects and tasks, users and groups, approvals, attendance, expenses, tags, billing rates and exports.

- Authentication: apiKey

## Tools (148)

- **Add allowed group to tag**: Add allowed group to tag. Add allowed group to tag. Do not provide `group_id` in url.
- **Add/change color in task**: Add/change color in task. Creates job to add/change a task color (for everyone).
- **Add tags to task**: Add tags to task
- **Add tags to time entry**: Add tags to time entry. Assing tags to time entry or entries.
- **Add task to favorite tasks list**: Add task to favorite tasks list
- **Archive a batch of tasks**: Archive a batch of tasks. Queues multiple active tasks for archiving. Tasks that are already archived are skipped.
- **Archive expense category**: Archive expense category
- **Assign groups to a project task**: Assign groups to a project task. Additively creates or updates direct group assignments and atomically materializes the resulting active users visible to the caller through the Projects PeoplePicker. Assignments omitted from the request are unchanged.
- **Assign or update a tag list assignment for a task**: Assign or update a tag list assignment for a task. Idempotent upsert of a direct assignment between a tag list and a task in the `tc_tt_task_tag_lists` table. If a direct row for the given pair `(taskId, tagListId)` already exists, only the `mandatory` flag is updated. If no direct row exists, a new
- **Assign users to project task**: Assign users to project task. Assigns one or more users to the selected project task with the provided project role.
- **Assign value to custom fields**: Assign value to custom fields
- **Attendance calendar search (beta)**: Attendance calendar search [beta]. Returns attendance calendar data for users in a date range. Note: This is a beta version.
- **Bulk change status of approval**: Bulk change status of approval
- **Cancel running timer**: Cancel running timer. Cancel the current timer for the authenticated user without creating or updating a time entry. Use the stop endpoint when tracked time should be saved. The operation is idempotent when no timer is running.
- **Change status of approval**: Change status of approval
- **Create approval message**: Create approval message
- **Create attendance request (beta)**: Create attendance request [beta]. Creates an attendance request for a specified user and date. The request can be created by the user themselves or by an administrator/supervisor for another user. Depending on permissions and day type settings, the request may be auto-approved or require manual appr
- **Create Custom Field Template**: Create Custom Field Template
- **Create expense**: Create expense
- **Create expense category**: Create expense category
- **Create export request**: Create export request
- **Create group**: Create group. Add new group. Edit permission is required. There cannot be more than one root group (with parent_id = 0). Maximum group tree depth is 4 levels. If you get an error 403 `You can not change this group` try to wait about one minute and retry.
- **Create new tag list**: Create new tag list. Create new tag list.
- **Create new task**: Create new task. Create new task. To ceate new task you should have proper permissions.
- **Create Predefined Days (beta)**: Create Predefined Days [beta]. Create predefined days for a group. Note: This is a beta version.
- **Create tag**: Create tag. Create tag. Do not provide `tag_id` in url, because while creating new tag a new, unique `tag_id` will be made. If you provide `tag_id` in url, a 400 HTTP response is returned.
- **Create time entry**: Create time entry. Create a time entry.
- **Create Time Entry restriction**: Create Time Entry restriction. Create specific restriction. An additional setting must be enabled for this endpoint to work - please contact support if you would like us to enable it.
- **Create time tracking role**: Create time tracking role. Create time tracking role.
- **Create/Update approval**: Create/Update approval. Create new approval or update existing one.
- **Create/Update group scheduler**: Create/Update group scheduler. Create or update group scheduler.
- **Delete allowed group from tag**: Delete allowed group from tag. Delete allowed group from tag.
- **Delete expense**: Delete expense
- **Delete expense attachment**: Delete expense attachment
- **Delete group**: Delete group. Delete a group. Edit permission is required. Root Group (`parent_id == 0`) cannot be deleted. All subgroups of deleted group have their `parent_id` changed to `root_group_id`. WARNING: backend might not return a response, but changes will be applied!
- **Delete group scheduler**: Delete group scheduler. Delete group scheduler.
- **Delete group setting**: Delete group setting. Delete group setting.
- **Delete tags from time entry**: Delete tags from time entry. Delete tags from time entry.
- **Delete task from favorite tasks list**: Delete task from favorite tasks list
- **Delete time entry**: Delete time entry. Delete a time entry by id.
- **Delete Time Entry restriction**: Delete Time Entry restriction. Delete specific restriction. If you don't know id of restriction you want to delete see time-entry-restriction/list endpoint. An additional setting must be enabled for this endpoint to work - please contact support if you would like us to enable it.
- **Delete time tracking role**: Delete time tracking role. Delete time tracking role.
- **Delete user from group**: Delete user from group. Delete user from group.
- **Delete user setting**: Delete user setting. Delete user setting.
- **Detach a tag list from a task**: Detach a tag list from a task. Idempotent deletion of the direct assignment row between a tag list and a task in `tc_tt_task_tag_lists`. Only the row with `task_id = taskId` is deleted; rows on ancestor tasks remain untouched, so an inherited tag list will still be visible via `getForTask` after thi
- **Edit tags assignment type**: Edit tags assignment type
- **Effective Predefined Days Assigned To Group (beta)**: Effective Predefined Days Assigned To Group [beta]. List of all day types assigned to a group along with inheritance from parent groups. Note: This is a beta version.
- **Get all groups**: Get all groups. Get all groups.
- **Get all users data**: Get all users data. Retrieves information about all users in an account
- **Get approval**: Get approval. Get approval by id
- **Get approvals**: Get approvals. Get approval or approvals
- **Get approval users**: Get approval users. Returns list with user ids which you are able to either approve or reject.
- **Get attendance**: Get attendance
- **Get billing rate for group**: Get billing rate for group. Returns all billing rates for given `group_id` or returns specific `rate_id` data for given `group_id`.
- **Get billing rate for task**: Get billing rate for task. Returns all billing rates for given `task_id` or returns specific `rate_id` data for given `task_id`.
- **Get billing rate for "task user"**: Get billing rate for "task user". Returns all billing rates for given `task_id` and `user_id` or returns specific `rate_id` data for given `task_id` and `user_id`.
- **Get billing rate for user**: Get billing rate for user. Returns billing rate for given user or users.
- **Get computer activities**: Get computer activities. Get computer activities.
- **Get expense attachment**: Get expense attachment
- **Get export request**: Get export request. Use the export UUID to get an export. Legacy numeric IDs are accepted through October 31, 2026; starting November 1, 2026, only UUIDs are accepted.
- **Get exports**: Get exports
- **Get group logo**: Get group logo. Returns url to group logo.
- **Get group scheduler**: Get group scheduler. Get group scheduler.
- **Get group setting**: Get group setting. Returns setting for given group_id.
- **Get list of dataset availability**: Get list of dataset availability
- **Get logged time in a week**: Get logged time in a week. This endpoint gets a `day` and returns array with summarized entries time per day for this week. The time is returned in seconds.
- **Get only tags of a tag list**: Get only tags of a tag list. Get tags from a specific tag list.
- **Get open exports**: Get open exports
- **Get project time-entry summary**: Get project time-entry summary. Returns time tracked directly on the project task and on its descendants.
- **Get tag allowed groups**: Get tag allowed groups. Get tag allowed groups Returns tags available in a group
- **Get tag data**: Get tag data. Get tag data.
- **Get tag list**: Get tag list. Get tag list data.
- **Get tag list with tags**: Get tag list with tags. Get tag list tags.
- **Get task details**: Get task details. Get task details.
- **Get task info**: Get task info. Returns information about task or tasks. If asked about specific task (`task_id` or `external_task_id` was provided) and no task was found it returns error status of `404 Not Found`.
- **Get the list of files from the user's main group**: Get the list of files from the user's main group
- **Get time entries by user permissions**: Get time entries by user permissions. Get time entries by user access and permissions.
- **Get time entries changes**: Get time entries changes. Get time enties changes.
- **Get time entries deletions**: Get time entries deletions. Get time enties deletions.
- **Get time entry tags**: Get time entry tags. Get tags for a given time entry ID.
- **Get timer status**: Get timer status. Return current timer status for the authenticated user.
- **Get time tracking roles**: Get time tracking roles. Returns roles allowed for your root group with permissions.
- **Get user**: Get user. Returns user's information. If `user_id` is not provided then returns current user data. Provide comma separated ids for multiple users ie. `132,423,456`.
- **Get user setting**: Get user setting. Return user's setting value.
- **Get users in group**: Get users in group. Get users from given group.
- **Get visible running timers**: Get visible running timers. Return running timers for users visible in the authenticated user's permission tree.
- **Get your user data**: Get your user data. Get your user data.
- **Has Pending Attendance Requests (beta)**: Has Pending Attendance Requests [beta]. Checks if the current user has any pending attendance requests to process. Note: This is a beta version.
- **Insert or update user attendance records**: Insert or update user attendance records. Inserts or updates attendance records for a user. Each entry corresponds to one day. The `shouldBe` and `vacationTime` fields are optional. **Important:** The date range constraint does not mean a limit of 100 entries, but rather that the maximum range betwe
- **Invite user to a group**: Invite user to a group. Invite user to a group.
- **Invoice assign to expense**: Invoice assign to expense
- **Invoice unassign from expense**: Invoice unassign from expense
- **List approval**: List approval. Get approval list by filters
- **List approval activities**: List approval activities. Get approval activities by filters
- **List assigned users for project task**: List assigned users for project task. Returns active users assigned to a task, including task inheritance and source-group metadata.
- **List Custom Field Templates**: List Custom Field Templates
- **List expense category**: List expense category
- **List expense (GET /v3/expense/list)**: List expense. List expense (GET /v3/expense/list)
- **List expense (POST /v3/expense/list)**: List expense. List expense (POST /v3/expense/list)
- **List group assignment sources for a project task**: List group assignment sources for a project task. Returns all visible direct and inherited group assignment sources from the requested task hierarchy. The same groupId can occur more than once when it is assigned at multiple hierarchy levels. A null inheritedFromTaskId identifies an assignment creat
- **List of favorite tasks**: List of favorite tasks
- **List of sites and apps**: List of sites and apps
- **List projects tree**: List projects tree
- **List restrictions**: List restrictions. List all time entry restriction filtered by given params. An additional setting must be enabled for this endpoint to work - please contact support if you would like us to enable it.
- **List visible user groups as a tree**: List visible user groups as a tree. Returns the user-group tree visible to the authenticated caller, with distinct active-user counts. The result is independent of any project or task assignment.
- **Load selected data for projects**: Load selected data for projects. Loads one additional projects-view data extension for up to 500 permitted tasks.
- **Merge time entries**: Merge time entries. Merge two time entries into one.
- **Modify Custom Field Template**: Modify Custom Field Template
- **Predefined Days Assigned To Group (beta)**: Predefined Days Assigned To Group [beta]. List of all predefined days assigned directly to given group. Note: This is a beta version.
- **Remove a group assignment from a project task**: Remove a group assignment from a project task. Removes only the exact direct group-to-task assignment and atomically reconciles materialized active users visible to the caller through the Projects PeoplePicker. An assignment inherited through an ancestor group cannot be removed through a descendant
- **Remove Custom Field Template**: Remove Custom Field Template
- **Remove Predefined Day (beta)**: Remove Predefined Day [beta]. Remove predefined day from a group. Note: This is a beta version.
- **Remove tags from task**: Remove tags from task
- **Restore a batch of archived tasks and their parent hierarchy**: Restore a batch of archived tasks and their parent hierarchy. Restores a batch of archived tasks. When restoring tasks, their parent tasks (if archived) will also be restored to maintain task tree consistency. However, siblings of restored tasks will remain archived unless explicitly included in the
- **Retrieve all possible day types for attendance**: Retrieve all possible day types for attendance. Returns a list of all possible day types to declare in attendance.
- **Retrieve attendance data for a user within a date range**: Retrieve attendance data for a user within a date range
- **Retrieves day types declared by users in given timeframe**: Retrieves day types declared by users in given timeframe. Get day types for giver period for team
- **Retrieve value for custom field in resource**: Retrieve value for custom field in resource
- **Retrieve values for all custom fields in resource**: Retrieve values for all custom fields in resource
- **Search in projects tree**: Search in projects tree
- **Send reminder**: Send reminder
- **Start timer**: Start timer. Start a timer for the authenticated user.
- **Stop timer**: Stop timer. Stop the current timer for the authenticated user.
- **Storage get file**: Storage get file
- **Task change parent**: Task change parent
- **Task duplicate**: Task duplicate
- **Task duplicate batch**: Task duplicate batch
- **Task remove**: Task remove
- **Task worklog move**: Task worklog move
- **Unassign users from project task**: Unassign users from project task. Removes direct user assignments from the selected project task.
- **Unassign value from custom fields**: Unassign value from custom fields
- **Update/create billing rate for group**: Update/create billing rate for group. This endpoint updates value or creates new rate for given `rateTypeId` and `group_id`.
- **Update/create billing rate for task**: Update/create billing rate for task. This endpoint updates value or creates new rate for given `rateTypeId` and `task_id`.
- **Update/create billing rate for "task user"**: Update/create billing rate for "task user". This endpoint updates value or creates new rate for given `rateTypeId` and `task_id`.
- **Update/create billing rate for user**: Update/create billing rate for user. This endpoint updates value or creates new rate for given `rateTypeId` and `user_id`.
- **Update expense**: Update expense
- **Update expense category**: Update expense category
- **Update group**: Update group. Modify existing group. Edit permission is required. WARNING: backend might not return a response, but changes will be applied!
- **Update group setting**: Update group setting. Update group setting.
- **Update tag**: Update tag. Modify tag data.
- **Update tag list data**: Update tag list data. Update tag list data.
- **Update task info**: Update task info. Modify existing task. To modify a task you should have proper permissions.
- **Update time entry**: Update time entry. Update a time entry by id.
- **Update time tracking role**: Update time tracking role. Update time tracking role. Note you can't edit `Regular User` role.
- **Update user**: Update user. Update user's data. If `user_id` is not provided, the data for the user associated with the API key will be updated.
- **Update user in group**: Update user in group. Update user in group or move user to other group.
- **Update user setting**: Update user setting. Update user setting.
- **Upload expense attachment**: Upload expense attachment

Connect TimeCamp in General Input: https://www.generalinput.com/apps/timecamp