Timely logo

Timely

Connect Timely through Nango.

26 agent tools Integration catalog
Request access
Connect Timely and choose your agent’s tools.
01 · WHAT THE AGENT CAN DO

Agent tools

Each tool is an action the agent calls by name, scoped to what you authorize and recorded in the run trace.

create clientTIMELY_CREATE_CLIENT
Create a new client (company) in Timely.
create eventTIMELY_CREATE_EVENT
Log a new time entry against a project.
create labelTIMELY_CREATE_LABEL
Create a new label, optionally nested under a parent label.
create projectTIMELY_CREATE_PROJECT
Create a new project under a client (company).
delete eventTIMELY_DELETE_EVENT
Permanently delete a single logged time entry.
delete labelTIMELY_DELETE_LABEL
Permanently delete a label.
delete project safelyTIMELY_DELETE_PROJECT_SAFELY
Delete a project after checking for logged time, blocking by default unless confirm is true.
delete projectTIMELY_DELETE_PROJECT
Permanently delete a project. WARNING: confirmed live to cascade-delete every event (time entry) logged against it.
get clientTIMELY_GET_CLIENT
Retrieve a single client by ID, including inactive ones.
get eventTIMELY_GET_EVENT
Retrieve a single logged time entry by ID.
get labelTIMELY_GET_LABEL
Retrieve a single label by ID, including its child labels.
get project time summaryTIMELY_GET_PROJECT_TIME_SUMMARY
COMPOSITE: get a project's all-time totals AND a date-range-scoped total-plus-entry-breakdown, in one call - fills the gap left by get-project silently ignoring since/upto.
get projectTIMELY_GET_PROJECT
Retrieve a single project by ID, including its all-time logged duration/cost aggregates.
get time reportTIMELY_GET_TIME_REPORT
Get a date-range-scoped rollup of logged time and cost, grouped by client then project.
get userTIMELY_GET_USER
Retrieve a single Timely user by ID.
list accountsTIMELY_LIST_ACCOUNTS
List the Timely accounts this connection can access, to discover the account_id required by every other action/sync in this registry.
list clientsTIMELY_LIST_CLIENTS
List all active clients (companies) in a Timely account.
list eventsTIMELY_LIST_EVENTS
List logged time entries (Timely events), optionally filtered by day range and/or project.
list labelsTIMELY_LIST_LABELS
List all labels in the account (hierarchical - top-level labels carry a children array).
list projectsTIMELY_LIST_PROJECTS
List all projects in a Timely account.
list usersTIMELY_LIST_USERS
List all users (team members) in the account.
log time to named projectTIMELY_LOG_TIME_TO_NAMED_PROJECT
Log time against a project identified by name, creating the project first (under a given or default client) if no project with that exact name already exists.
update clientTIMELY_UPDATE_CLIENT
Update a client's fields (partial merge), including deactivating it via active:false - the only confirmed way to 'remove' a client since no delete endpoint exists.
update eventTIMELY_UPDATE_EVENT
Update a logged time entry (partial merge).
update labelTIMELY_UPDATE_LABEL
Update a label's fields (partial merge) - e.g. rename it.
update projectTIMELY_UPDATE_PROJECT
Update a project's fields (partial merge) - e.g. rename it, change its rate_type, or flip enable_labels to allow labeled time entries.