Timely - Nango Docs

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Others

Function name	Description	Type	Source code
`create-client`	Create a new client (company) in Timely.	Action	🔗 Github
`create-event`	Log a new time entry against a project.	Action	🔗 Github
`create-label`	Create a new label, optionally nested under a parent label.	Action	🔗 Github
`create-project`	Create a new project under a client (company).	Action	🔗 Github
`delete-event`	Permanently delete a single logged time entry.	Action	🔗 Github
`delete-label`	Permanently delete a label.	Action	🔗 Github
`delete-project-safely`	Delete a project after checking for logged time, blocking by default unless confirm is true.	Action	🔗 Github
`delete-project`	Permanently delete a project. WARNING: confirmed live to cascade-delete every event (time entry) logged against it.	Action	🔗 Github
`get-client`	Retrieve a single client by ID, including inactive ones.	Action	🔗 Github
`get-event`	Retrieve a single logged time entry by ID.	Action	🔗 Github
`get-label`	Retrieve a single label by ID, including its child labels.	Action	🔗 Github
`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.	Action	🔗 Github
`get-project`	Retrieve a single project by ID, including its all-time logged duration/cost aggregates.	Action	🔗 Github
`get-time-report`	Get a date-range-scoped rollup of logged time and cost, grouped by client then project.	Action	🔗 Github
`get-user`	Retrieve a single Timely user by ID.	Action	🔗 Github
`list-accounts`	List the Timely accounts this connection can access, to discover the account_id required by every other action/sync in this registry.	Action	🔗 Github
`list-clients`	List all active clients (companies) in a Timely account.	Action	🔗 Github
`list-events`	List logged time entries (Timely events), optionally filtered by day range and/or project.	Action	🔗 Github
`list-labels`	List all labels in the account (hierarchical - top-level labels carry a children array).	Action	🔗 Github
`list-projects`	List all projects in a Timely account.	Action	🔗 Github
`list-users`	List all users (team members) in the account.	Action	🔗 Github
`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.	Action	🔗 Github
`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.	Action	🔗 Github
`update-event`	Update a logged time entry (partial merge).	Action	🔗 Github
`update-label`	Update a label’s fields (partial merge) - e.g. rename it.	Action	🔗 Github
`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.	Action	🔗 Github
`clients`	Sync all active clients in the connected Timely account(s).	Sync	🔗 Github
`events`	Sync logged time entries (‘events’) within a bounded, caller-configurable day range - full refresh per window, since no working incremental filter exists.	Sync	🔗 Github
`projects`	Sync all projects in the account.	Sync	🔗 Github
`users`	Sync all users (team members) in the account.	Sync	🔗 Github

Nango has a Nango-managed OAuth app you can use in development and production. Select it when you create the integration.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

You need to be the administrator of a Timely account to register an app (under Settings -> Devs).
Getting started with the Timely API
Web API docs (their REST API)

Contribute useful links by editing this page

API gotchas

No scopes required.

Contribute API gotchas by editing this page

​Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​Pre-built tooling

​Others

​Access requirements

​Setup guide

​Useful links

​API gotchas

Overview

Pre-built tooling

Others

Access requirements

Setup guide

Useful links

API gotchas