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.
Tools (41)
Timely Create Client
Timely Create ClientIntegration 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.
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
Timely Create Day LockingIntegration 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.
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
Timely Create LabelIntegration 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.
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
Timely Create ReportIntegration 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.
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
Timely Create TeamIntegration 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.
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
Timely Create WebhookIntegration 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.
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
Timely Delete LabelIntegration 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.
id
integer
✅
4525340
The label ID to delete
account_id
integer
✅
1123656
The ID of the account
Timely Delete Team
Timely Delete TeamIntegration 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.
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
Timely Delete WebhookIntegration 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.
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
Timely Filter ReportsIntegration 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.
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
Timely Get ActivitiesIntegration 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.
account_id
integer
1123656
Timely account ID to retrieve activities for. Optional; if not provided, the first accessible account is used.
Timely Get Client
Timely Get ClientIntegration 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.
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
Timely Get Current PermissionsIntegration 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.
account_id
integer
✅
1123656
The ID of the account
Timely Get Current User
Timely Get Current UserIntegration 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.
account_id
integer
✅
1123656
Account ID
Timely Get Label
Timely Get LabelIntegration 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.
id
integer
✅
4313137
The label ID to retrieve
account_id
integer
✅
1123656
The ID of the account
Timely Get Project
Timely Get ProjectIntegration 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.
id
integer
✅
5045094
The project ID to retrieve
account_id
integer
✅
1123656
The ID of the account that owns the project
Timely Get Team
Timely Get TeamIntegration 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.
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
Timely Get UserIntegration 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.
id
integer
✅
2308901
The user ID to retrieve
account_id
integer
✅
1123656
The ID of the account
Timely Get User Capacities
Timely Get User CapacitiesIntegration 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.
user_id
integer
✅
2308901
The user ID to retrieve capacities for
account_id
integer
✅
1123656
The ID of the account
Timely Get User Permissions
Timely Get User PermissionsIntegration 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.
user_id
integer
✅
2308901
The user ID to retrieve permissions for
account_id
integer
✅
1123656
The ID of the account
Timely Get Webhook
Timely Get WebhookIntegration 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.
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
Timely List AccountsIntegration 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
Timely List ClientsIntegration 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.
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
Timely List EventsIntegration 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.
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
Timely List ForecastsIntegration 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.
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
Timely List LabelsIntegration 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.
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
Timely List Project EventsIntegration 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.
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
Timely List ProjectsIntegration 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.
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
Timely List RolesIntegration 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.
account_id
integer
✅
1123656
Timely account ID to list roles for
Timely List Teams
Timely List TeamsIntegration 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.
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
Timely List User EventsIntegration 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.
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
Timely List UsersIntegration 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.
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
Timely List WebhooksIntegration 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.
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
Timely Process Bulk EventsIntegration 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.
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
Timely Retrieve AccountIntegration 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.
id
integer
✅
364
Identifier of the account to retrieve
Timely Update Client
Timely Update ClientIntegration 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.
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
Timely Update Day LockingIntegration 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.
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
Timely Update LabelIntegration 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.
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
Timely Update ProjectIntegration 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.
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
Timely Update UserIntegration 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.
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
Timely Update WebhookIntegration 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.
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.