Timely is an automatic time-tracking platform capturing activity across applications, calendars, and devices, creating detailed timesheets for billing or productivity insights
Timely is an automatic time-tracking platform capturing activity across applications, calendars, and devices, creating detailed timesheets for billing or productivity insights On Nagent, Timely is exposed as a fully-configurable time tracking software integration that any agent can call — 41 actions, and OAuth authentication. No code is required to wire Timely into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Timely to automate the kinds of tasks time tracking software teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Timely into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Timely, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TIMELY_CREATE_CLIENTTool 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.
Input parameters
Client name (must be unique within the account).
Hexadecimal color code (without '#') for the client. Used for visual identification in the Timely UI.
Whether the client is active. Defaults to true.
Timely account ID where the client will be created. Optional; if not provided, the first accessible account is used.
Optional external identifier for syncing with external systems. Use this to map the client to your own system's ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_CREATE_DAY_LOCKINGTool 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.
Input parameters
Timely account ID to create the day locking for. Optional; if not provided, the first accessible account is used.
Day property object containing user IDs, dates, and locked status
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_CREATE_LABELTool 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.
Input parameters
The name of the label to create.
Hex color code for the label without the '#' prefix (e.g., '1976d2', '00796b'). A random color is assigned if omitted.
Parent label ID for creating hierarchical labels. Omit for top-level labels.
Timely account ID where the label will be created. Optional; if not provided, the first accessible account is used.
External identifier reference for integration purposes. Must be alphanumeric, maximum 512 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_CREATE_REPORTTool 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.
Input parameters
Start date for the report period in YYYY-MM-DD format
End date for the report period in YYYY-MM-DD format
Comma-separated list of user IDs to filter reports by
Timely account ID to generate reports for. Optional; if not provided, the first accessible account is used.
Comma-separated list of project IDs to filter reports by
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_CREATE_TEAMTool to create a new team in the specified Timely account. Use when organizing users into teams for better collaboration and project management.
Input parameters
Name of the team to create
6-character hex color code without # symbol for the team (e.g., 1976d2, 00796b, 2e7d32)
Array of user IDs to add as members of the team
Timely account ID where the team will be created. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_CREATE_WEBHOOKTool to create a new webhook for the specified account. Use after specifying the target URL and event subscriptions. Call only once per configuration.
Input parameters
The HTTPS endpoint that will receive webhook payloads.
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.
Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely.
List of event types to subscribe to for receiving notifications.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_DELETE_LABELTool to delete a label by ID from a Timely account. Use when you need to remove an existing label.
Input parameters
The label ID to delete
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_DELETE_TEAMTool 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.
Input parameters
Team ID to delete
Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_DELETE_WEBHOOKTool to delete an existing webhook by its ID. Use when you need to remove a webhook subscription from an account.
Input parameters
The unique identifier of the webhook to delete.
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_FILTER_REPORTSTool 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.
Input parameters
End date for the report filter in YYYY-MM-DD format
Start date for the report filter in YYYY-MM-DD format
Filter by billing status. True for billed hours, False for unbilled hours, None for both.
List of team IDs to filter reports by
List of user IDs to filter reports by. If not provided, includes all users.
List of label/tag IDs to filter reports by
Timely account ID to filter reports for. Optional; if not provided, the first accessible account is used.
List of project IDs to filter reports by. If not provided, includes all projects.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_ACTIVITIESTool 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.
Input parameters
Timely account ID to retrieve activities for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_CLIENTTool 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.
Input parameters
The client ID to retrieve
Timely account ID that contains the client. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_CURRENT_PERMISSIONSTool to retrieve the current user's permissions for a specified account. Use when you need to check what actions the authenticated user can perform.
Input parameters
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_CURRENT_USERTool to retrieve the currently authenticated user. Use when you need to get details of the logged-in user.
Input parameters
Account ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_LABELTool 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.
Input parameters
The label ID to retrieve
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_PROJECTTool 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.
Input parameters
The project ID to retrieve
The ID of the account that owns the project
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_TEAMTool to retrieve details of a specific team by its ID. Use when you need to fetch team information including name, color, and members.
Input parameters
Team ID to retrieve
Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_USERTool to retrieve a user by ID from a Timely account. Use when you need to fetch user details such as name, email, and avatar.
Input parameters
The user ID to retrieve
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_USER_CAPACITIESTool to retrieve capacity information for a specific user in a Timely account. Use when you need to check user work capacity or availability schedules.
Input parameters
The user ID to retrieve capacities for
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_USER_PERMISSIONSTool 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.
Input parameters
The user ID to retrieve permissions for
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_GET_WEBHOOKTool to retrieve a specific webhook by its ID. Use when you need to check the configuration or status of an existing webhook.
Input parameters
The unique identifier of the webhook to retrieve.
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_ACCOUNTSRetrieve all accessible Timely accounts for the authenticated user. Example: "List all Timely accounts"
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_CLIENTSTool 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.
Input parameters
Filter clients by status: 'active' for active clients (default), 'archived' for archived clients, or 'all' for both
Maximum number of clients to retrieve (default: 10000)
Sort direction: 'asc' for ascending or 'desc' for descending (default: asc)
Number of clients to skip before retrieving results
Timely account ID to list clients for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_EVENTSTool 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.
Input parameters
Comma-separated project IDs to filter events by
Comma-separated user IDs to filter events by
Number of results per page (default 50)
Start date filter in YYYY-MM-DD format
End date filter in YYYY-MM-DD format
Offset for pagination (number of records to skip)
Timely account ID to list events for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_FORECASTSTool 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.
Input parameters
Start date filter (YYYY-MM-DD) to retrieve forecasts from this date onwards
End date filter (YYYY-MM-DD) to retrieve forecasts up to this date
Timely account ID to list forecasts for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_LABELSTool 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.
Input parameters
Maximum number of labels to retrieve
Number of labels to skip before retrieving results
Filter to show only child labels of a specific parent label
Timely account ID to list labels for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_PROJECT_EVENTSTool 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.
Input parameters
The ID of the Timely account
The ID of the project to retrieve events for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_PROJECTSTool 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.
Input parameters
Field to sort projects by (default: name)
Maximum number of projects to retrieve
Sort direction: 'asc' for ascending or 'desc' for descending (default: asc)
Filter projects by state: 'active' for active projects or 'archived' for archived ones
Additional filtering options (deprecated parameter)
Number of projects to skip before retrieving results
Filter projects by relationship type
Timely account ID to list projects for. Optional; if not provided, the first accessible account is used.
Comma-separated list of project IDs to filter by
Comma-separated list of external IDs to filter by
Retrieve only projects updated after this timestamp (ISO 8601 format or Unix timestamp)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_ROLESTool 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.
Input parameters
Timely account ID to list roles for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_TEAMSTool to list all teams in the specified Timely account. Use when you need to retrieve all teams for collaboration and project management purposes.
Input parameters
Timely account ID to list teams for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_USER_EVENTSTool 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.
Input parameters
The user ID to retrieve events for
The ID of the Timely account. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_USERSTool 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.
Input parameters
Number of results per page (default 50)
Filter options for user list.
Offset for pagination
Account ID to list users for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_LIST_WEBHOOKSTool to list all webhooks in the specified account. Use when you need to see existing webhook configurations or verify webhook setup.
Input parameters
Timely account ID to list webhooks for. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_PROCESS_BULK_EVENTSTool 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.
Input parameters
Array of event objects to create (max 100 per request)
Array of event IDs to delete (max 100 per request)
Array of event objects with IDs to update (max 100 per request)
Timely account ID to perform bulk operations on
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_RETRIEVE_ACCOUNTTool 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"
Input parameters
Identifier of the account to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_CLIENTTool 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.
Input parameters
The client ID to update
Client data to update
The ID of the account. Optional; if not provided, the first accessible account is used.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_DAY_LOCKINGTool 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.
Input parameters
The ID of the account. Optional; if not provided, the first accessible account is used
Day property object containing locking settings
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_LABELTool to update a label by ID in a Timely account. Use when you need to modify an existing label's name, color, or hierarchy.
Input parameters
The label ID to update
Label fields to update
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_PROJECTTool 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.
Input parameters
The project ID to update
Project data to update
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_USERTool 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.
Input parameters
The user ID to update
User data to update
The ID of the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIMELY_UPDATE_WEBHOOKTool to update an existing webhook by ID. Use when you need to modify webhook settings such as URL, subscriptions, or active status.
Input parameters
The webhook ID to update.
The HTTPS endpoint that will receive webhook payloads.
Whether the webhook is active.
The ID of the account the webhook belongs to.
Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely.
List of event types to subscribe to for receiving notifications.
Custom headers to send with webhook requests.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 36 agents privately built on Nagent that already use Timely.
Build on Nagent
Connect Timely to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Timely, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Timely is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Timely is connected, you configure its 41 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Timely steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Timely event fires, the agent kicks off automatically.
Every Timely action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Timely ships with 41 pre-built time tracking software actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Timely together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Timely-based workflows tailored to your business.