Timely
Overview
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 Tenklo 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 |
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