# Timely Your Toolhouse AI Worker can connect to Timely using 41 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=timely). ## Tools (41) ### `Timely Create Client` Integration name: **TIMELY\_CREATE\_CLIENT** Tool to create a new client in the specified Timely account. Use when adding a new client to track time against. Client names must be unique within an account. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Test Client via API"` | Client name (must be unique within the account). | | `color` | string | | `"1976d2"` | Hexadecimal color code (without '#') for the client. Used for visual identification in the Timely UI. | | `active` | boolean | | `true` | Whether the client is active. Defaults to true. | | `account_id` | integer | | `1123656` | Timely account ID where the client will be created. Optional; if not provided, the first accessible account is used. | | `external_id` | string | | `"ext-12345"` | Optional external identifier for syncing with external systems. Use this to map the client to your own system's ID. | *** ### `Timely Create Day Locking` Integration name: **TIMELY\_CREATE\_DAY\_LOCKING** Tool to create a day locking entry that prevents editing of time entries for specific dates and users. Use when you need to lock time entries to prevent modifications after approval or billing. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------- | | `account_id` | integer | | `1123656` | Timely account ID to create the day locking for. Optional; if not provided, the first accessible account is used. | | `day_property` | object | ✅ | — | Day property object containing user IDs, dates, and locked status | *** ### `Timely Create Label` Integration name: **TIMELY\_CREATE\_LABEL** Tool to create a new label in the specified Timely account. Use when you need to create a label for categorizing projects, time entries, or other resources. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------- | ---------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Test Label"` | The name of the label to create. | | `color` | string | | `"1976d2"` | Hex color code for the label without the '#' prefix (e.g., '1976d2', '00796b'). A random color is assigned if omitted. | | `parent_id` | integer | | `123` | Parent label ID for creating hierarchical labels. Omit for top-level labels. | | `account_id` | integer | | `1123656` | Timely account ID where the label will be created. Optional; if not provided, the first accessible account is used. | | `external_id` | string | | `"ext-label-001"` | External identifier reference for integration purposes. Must be alphanumeric, maximum 512 characters. | *** ### `Timely Create Report` Integration name: **TIMELY\_CREATE\_REPORT** Tool to generate reports for a Timely account with optional filters. Use when you need to create reports for time tracking, billing analysis, or project summaries with date range or user/project filters. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------------- | ----------------------------------------------------------------------------------------------------------- | | `since` | string | | `"2024-01-01"` | Start date for the report period in YYYY-MM-DD format | | `until` | string | | `"2024-12-31"` | End date for the report period in YYYY-MM-DD format | | `user_ids` | string | | `"5172,5173"` | Comma-separated list of user IDs to filter reports by | | `account_id` | integer | | `1123656` | Timely account ID to generate reports for. Optional; if not provided, the first accessible account is used. | | `project_ids` | string | | `"2104,2105"` | Comma-separated list of project IDs to filter reports by | *** ### `Timely Create Team` Integration name: **TIMELY\_CREATE\_TEAM** Tool to create a new team in the specified Timely account. Use when organizing users into teams for better collaboration and project management. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------------------- | ------------------------------------------------------------------------------------------------------------------ | | `name` | string | ✅ | `"Test Team"` | Name of the team to create | | `color` | string | ✅ | `"1976d2"` | 6-character hex color code without # symbol for the team (e.g., 1976d2, 00796b, 2e7d32) | | `user_ids` | array | | `[2308901,2308902]` | Array of user IDs to add as members of the team | | `account_id` | integer | | `1123656` | Timely account ID where the team will be created. Optional; if not provided, the first accessible account is used. | *** ### `Timely Create Webhook` Integration name: **TIMELY\_CREATE\_WEBHOOK** Tool to create a new webhook for the specified account. Use after specifying the target URL and event subscriptions. Call only once per configuration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `url` | string | ✅ | `"https://example.com/webhook"` | The HTTPS endpoint that will receive webhook payloads. | | `account_id` | integer | | `364` | Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used. | | `secret_token` | string | | `"s3cr3tT0k3n"` | Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely. | | `subscriptions` | array | ✅ | `["hours:created","projects:updated"]` | List of event types to subscribe to for receiving notifications. | *** ### `Timely Delete Label` Integration name: **TIMELY\_DELETE\_LABEL** Tool to delete a label by ID from a Timely account. Use when you need to remove an existing label. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ---------------------- | | `id` | integer | ✅ | `4525340` | The label ID to delete | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Delete Team` Integration name: **TIMELY\_DELETE\_TEAM** Tool to delete a team by its ID. Use when you need to remove a specific team from the account. This operation is destructive and cannot be undone. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `15611` | Team ID to delete | | `account_id` | integer | | `1123656` | Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used. | *** ### `Timely Delete Webhook` Integration name: **TIMELY\_DELETE\_WEBHOOK** Tool to delete an existing webhook by its ID. Use when you need to remove a webhook subscription from an account. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `849` | The unique identifier of the webhook to delete. | | `account_id` | integer | | `364` | Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used. | *** ### `Timely Filter Reports` Integration name: **TIMELY\_FILTER\_REPORTS** Tool to filter Timely reports based on date range, users, projects, labels, teams, and billing status. Use when you need to generate custom reports with specific criteria or analyze time tracking data for specific periods or resources. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------------- | --------------------------------------------------------------------------------------------------------- | | `to` | string | | `"2024-01-31"` | End date for the report filter in YYYY-MM-DD format | | `from` | string | | `"2024-01-01"` | Start date for the report filter in YYYY-MM-DD format | | `billed` | boolean | | — | Filter by billing status. True for billed hours, False for unbilled hours, None for both. | | `team_ids` | array | | `[333,444]` | List of team IDs to filter reports by | | `user_ids` | array | | `[123,456]` | List of user IDs to filter reports by. If not provided, includes all users. | | `label_ids` | array | | `[111,222]` | List of label/tag IDs to filter reports by | | `account_id` | integer | | `364` | Timely account ID to filter reports for. Optional; if not provided, the first accessible account is used. | | `project_ids` | array | | `[789,101]` | List of project IDs to filter reports by. If not provided, includes all projects. | *** ### `Timely Get Activities` Integration name: **TIMELY\_GET\_ACTIVITIES** Tool to retrieve all activities (audit trail) for a Timely account. Activities include logged hours, created reports, shared reports, project changes, and other account events. Use when you need to view the activity log or audit trail for an account. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | -------------------------------------------------------------------------------------------------------------- | | `account_id` | integer | | `1123656` | Timely account ID to retrieve activities for. Optional; if not provided, the first accessible account is used. | *** ### `Timely Get Client` Integration name: **TIMELY\_GET\_CLIENT** Tool to retrieve details of a specific client by its ID. Use when you need to fetch client information such as name, color, active status, or external references. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------------------------------------------------------------------------------------------ | | `id` | integer | ✅ | `2017475` | The client ID to retrieve | | `account_id` | integer | | `1123656` | Timely account ID that contains the client. Optional; if not provided, the first accessible account is used. | *** ### `Timely Get Current Permissions` Integration name: **TIMELY\_GET\_CURRENT\_PERMISSIONS** Tool to retrieve the current user's permissions for a specified account. Use when you need to check what actions the authenticated user can perform. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | --------------------- | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Get Current User` Integration name: **TIMELY\_GET\_CURRENT\_USER** Tool to retrieve the currently authenticated user. Use when you need to get details of the logged-in user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ----------- | | `account_id` | integer | ✅ | `1123656` | Account ID | *** ### `Timely Get Label` Integration name: **TIMELY\_GET\_LABEL** Tool to retrieve a label by ID from a Timely account. Use when you need to fetch label details such as name, color, and parent relationship. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------ | | `id` | integer | ✅ | `4313137` | The label ID to retrieve | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Get Project` Integration name: **TIMELY\_GET\_PROJECT** Tool to retrieve a single project by its ID. Use when you need detailed information about a specific project, such as its name, budget, billable status, or associated client. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------------------------- | | `id` | integer | ✅ | `5045094` | The project ID to retrieve | | `account_id` | integer | ✅ | `1123656` | The ID of the account that owns the project | *** ### `Timely Get Team` Integration name: **TIMELY\_GET\_TEAM** Tool to retrieve details of a specific team by its ID. Use when you need to fetch team information including name, color, and members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `15610` | Team ID to retrieve | | `account_id` | integer | | `1123656` | Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used. | *** ### `Timely Get User` Integration name: **TIMELY\_GET\_USER** Tool to retrieve a user by ID from a Timely account. Use when you need to fetch user details such as name, email, and avatar. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ----------------------- | | `id` | integer | ✅ | `2308901` | The user ID to retrieve | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Get User Capacities` Integration name: **TIMELY\_GET\_USER\_CAPACITIES** Tool to retrieve capacity information for a specific user in a Timely account. Use when you need to check user work capacity or availability schedules. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | -------------------------------------- | | `user_id` | integer | ✅ | `2308901` | The user ID to retrieve capacities for | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Get User Permissions` Integration name: **TIMELY\_GET\_USER\_PERMISSIONS** Tool to retrieve a user's permissions by their ID. Use when you need to check what permissions a specific user has in a Timely account. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | --------------------------------------- | | `user_id` | integer | ✅ | `2308901` | The user ID to retrieve permissions for | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Get Webhook` Integration name: **TIMELY\_GET\_WEBHOOK** Tool to retrieve a specific webhook by its ID. Use when you need to check the configuration or status of an existing webhook. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `852` | The unique identifier of the webhook to retrieve. | | `account_id` | integer | | `364` | Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Accounts` Integration name: **TIMELY\_LIST\_ACCOUNTS** Retrieve all accessible Timely accounts for the authenticated user. Example: "List all Timely accounts" #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Timely List Clients` Integration name: **TIMELY\_LIST\_CLIENTS** Tool to list all clients in a Timely account with optional filtering and sorting. Use when you need to discover client IDs or names for project creation, reporting, or mapping external systems. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------- | | `show` | string | | `"active"` | Filter clients by status: 'active' for active clients (default), 'archived' for archived clients, or 'all' for both | | `limit` | integer | | `50` | Maximum number of clients to retrieve (default: 10000) | | `order` | string | | `"asc"` | Sort direction: 'asc' for ascending or 'desc' for descending (default: asc) | | `offset` | integer | | `0` | Number of clients to skip before retrieving results | | `account_id` | integer | | `364` | Timely account ID to list clients for. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Events` Integration name: **TIMELY\_LIST\_EVENTS** Tool to list all events (time entries) in a Timely account with optional filtering by date range, users, and projects. Use when you need to retrieve time entries for reporting, analysis, or synchronization with external systems. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------------- | ------------------------------------------------------------------------------------------------------ | | `pids` | string | | `"789,101"` | Comma-separated project IDs to filter events by | | `uids` | string | | `"123,456"` | Comma-separated user IDs to filter events by | | `limit` | integer | | `50` | Number of results per page (default 50) | | `since` | string | | `"2024-01-01"` | Start date filter in YYYY-MM-DD format | | `until` | string | | `"2024-12-31"` | End date filter in YYYY-MM-DD format | | `offset` | integer | | `0` | Offset for pagination (number of records to skip) | | `account_id` | integer | | `1123656` | Timely account ID to list events for. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Forecasts` Integration name: **TIMELY\_LIST\_FORECASTS** Tool to list all forecasts (tasks) in a Timely account with optional date filtering. Use when you need to view planned tasks, retrieve forecast IDs, or analyze scheduled work. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------------- | --------------------------------------------------------------------------------------------------------- | | `since` | string | | `"2024-01-01"` | Start date filter (YYYY-MM-DD) to retrieve forecasts from this date onwards | | `until` | string | | `"2024-12-31"` | End date filter (YYYY-MM-DD) to retrieve forecasts up to this date | | `account_id` | integer | | `1123656` | Timely account ID to list forecasts for. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Labels` Integration name: **TIMELY\_LIST\_LABELS** Tool to list all labels in a Timely account. Use when you need to discover label IDs or names for organizing projects and time entries. Can optionally filter to show only child labels by providing a parent\_id. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------------------------------------------------------------------------------------ | | `limit` | integer | | `50` | Maximum number of labels to retrieve | | `offset` | integer | | `0` | Number of labels to skip before retrieving results | | `parent_id` | integer | | `123` | Filter to show only child labels of a specific parent label | | `account_id` | integer | | `1123656` | Timely account ID to list labels for. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Project Events` Integration name: **TIMELY\_LIST\_PROJECT\_EVENTS** Tool to list all events (time entries) for a specific project in Timely. Use when you need to retrieve all time logs associated with a project for reporting, analysis, or verification. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | -------------------------------------------- | | `account_id` | integer | ✅ | `1123656` | The ID of the Timely account | | `project_id` | integer | ✅ | `5045094` | The ID of the project to retrieve events for | *** ### `Timely List Projects` Integration name: **TIMELY\_LIST\_PROJECTS** Tool to list all projects in a Timely account with optional filtering and sorting. Use when you need to discover project IDs or names for time entry creation, reporting, or mapping external systems. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------- | | `sort` | string | | `"name"` | Field to sort projects by (default: name) | | `limit` | integer | | `50` | Maximum number of projects to retrieve | | `order` | string | | `"asc"` | Sort direction: 'asc' for ascending or 'desc' for descending (default: asc) | | `state` | string | | `"active"` | Filter projects by state: 'active' for active projects or 'archived' for archived ones | | `filter` | string | | — | Additional filtering options (deprecated parameter) | | `offset` | integer | | `0` | Number of projects to skip before retrieving results | | `relation` | string | | `"member"` | Filter projects by relationship type | | `account_id` | integer | | `364` | Timely account ID to list projects for. Optional; if not provided, the first accessible account is used. | | `project_ids` | string | | `"123,456,789"` | Comma-separated list of project IDs to filter by | | `external_ids` | string | | `"ext-123,ext-456"` | Comma-separated list of external IDs to filter by | | `updated_after` | string | | `"2024-01-01T00:00:00Z"` | Retrieve only projects updated after this timestamp (ISO 8601 format or Unix timestamp) | *** ### `Timely List Roles` Integration name: **TIMELY\_LIST\_ROLES** Tool to list all available roles in a Timely account. Use when you need to discover role IDs or names for user assignment or permission management. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ----------------------------------- | | `account_id` | integer | ✅ | `1123656` | Timely account ID to list roles for | *** ### `Timely List Teams` Integration name: **TIMELY\_LIST\_TEAMS** Tool to list all teams in the specified Timely account. Use when you need to retrieve all teams for collaboration and project management purposes. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------- | | `account_id` | integer | | `1123656` | Timely account ID to list teams for. Optional; if not provided, the first accessible account is used. | *** ### `Timely List User Events` Integration name: **TIMELY\_LIST\_USER\_EVENTS** Tool to list all events (time entries) for a specific user in Timely. Use when you need to retrieve all time logs for a user for reporting, analysis, or verification. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ---------------------------------------------------------------------------------------------- | | `user_id` | integer | ✅ | `2308901` | The user ID to retrieve events for | | `account_id` | integer | | `1123656` | The ID of the Timely account. Optional; if not provided, the first accessible account is used. | *** ### `Timely List Users` Integration name: **TIMELY\_LIST\_USERS** Tool to list all users in a Timely account with optional filtering and pagination. Use when you need to discover user IDs, names, or emails for time entry creation, reporting, or user management. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------- | --------------------------------------- | | `limit` | integer | | `50` | Number of results per page (default 50) | | `filter` | string | | `"active"` | Filter options for user list. | | `offset` | integer | | `0` | Offset for pagination | | `account_id` | integer | ✅ | `1123656` | Account ID to list users for | *** ### `Timely List Webhooks` Integration name: **TIMELY\_LIST\_WEBHOOKS** Tool to list all webhooks in the specified account. Use when you need to see existing webhook configurations or verify webhook setup. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------- | | `account_id` | integer | | `364` | Timely account ID to list webhooks for. Optional; if not provided, the first accessible account is used. | *** ### `Timely Process Bulk Events` Integration name: **TIMELY\_PROCESS\_BULK\_EVENTS** Tool to create, update, or delete multiple events in a single bulk operation. Use when performing multiple event operations to improve efficiency. Supports up to 100 operations per request across create, update, and delete operations. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | --------------------------------------------------------------- | | `create` | array | | — | Array of event objects to create (max 100 per request) | | `delete` | array | | — | Array of event IDs to delete (max 100 per request) | | `update` | array | | — | Array of event objects with IDs to update (max 100 per request) | | `account_id` | integer | ✅ | `1123656` | Timely account ID to perform bulk operations on | *** ### `Timely Retrieve Account` Integration name: **TIMELY\_RETRIEVE\_ACCOUNT** Tool to retrieve details of a specific account by its ID. Use when you need to fetch fresh account info after confirming the ID. Example: "Retrieve account details for account ID 364" #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------- | | `id` | integer | ✅ | `364` | Identifier of the account to retrieve | *** ### `Timely Update Client` Integration name: **TIMELY\_UPDATE\_CLIENT** Tool to update an existing client by ID in Timely. Use when you need to modify client details such as name, status, color, or external ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | --------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `2090579` | The client ID to update | | `client` | object | ✅ | — | Client data to update | | `account_id` | integer | | `1123656` | The ID of the account. Optional; if not provided, the first accessible account is used. | *** ### `Timely Update Day Locking` Integration name: **TIMELY\_UPDATE\_DAY\_LOCKING** Tool to update day locking settings for specified users and dates. Use when you need to lock or unlock specific days for time tracking. Locked days prevent users from editing time entries on those dates. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | --------- | -------------------------------------------------------------------------------------- | | `account_id` | integer | | `1123656` | The ID of the account. Optional; if not provided, the first accessible account is used | | `day_property` | object | ✅ | — | Day property object containing locking settings | *** ### `Timely Update Label` Integration name: **TIMELY\_UPDATE\_LABEL** Tool to update a label by ID in a Timely account. Use when you need to modify an existing label's name, color, or hierarchy. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ---------------------- | | `id` | integer | ✅ | `4525342` | The label ID to update | | `label` | object | ✅ | — | Label fields to update | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Update Project` Integration name: **TIMELY\_UPDATE\_PROJECT** Tool to update a project by ID in a Timely account. Use when you need to modify project details such as name, description, billing status, or archive a project. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | ------------------------ | | `id` | integer | ✅ | `5045094` | The project ID to update | | `project` | object | ✅ | — | Project data to update | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Update User` Integration name: **TIMELY\_UPDATE\_USER** Tool to update a user by ID in a Timely account. Use when you need to modify user details such as email, name, role, or status. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | --------------------- | | `id` | integer | ✅ | `2308901` | The user ID to update | | `user` | object | ✅ | — | User data to update | | `account_id` | integer | ✅ | `1123656` | The ID of the account | *** ### `Timely Update Webhook` Integration name: **TIMELY\_UPDATE\_WEBHOOK** Tool to update an existing webhook by ID. Use when you need to modify webhook settings such as URL, subscriptions, or active status. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------- | :------: | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `850` | The webhook ID to update. | | `url` | string | | `"https://example.com/webhook2-updated"` | The HTTPS endpoint that will receive webhook payloads. | | `active` | boolean | | `true` | Whether the webhook is active. | | `account_id` | integer | ✅ | `1123656` | The ID of the account the webhook belongs to. | | `secret_token` | string | | `"your_secret_here"` | Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely. | | `subscriptions` | array | | `["hours:created","hours:updated","hours:deleted"]` | List of event types to subscribe to for receiving notifications. | | `custom_headers` | object | | `{"X-Custom-Header":"value"}` | Custom headers to send with webhook requests. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/timely.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.