Timely

Timely Delete Event

Delete a Timely time entry by id.

Timely Delete Forecast

Delete a Timely forecast by id.

Timely Delete Label

Delete a Timely label by id.

Timely Delete Project

Delete a Timely project by id. Destructive and idempotent — deleting an already-removed id may return 404.

Timely Get Accounts

List Timely accounts accessible with the current OAuth authorization. Call this first when account_id is unknown — every other Timely tool is scoped to one account id from this list.

Timely Get Clients

Read Timely clients (billing customers). Omit id to list clients with offset/limit pagination; pass id to fetch one client.

Timely Get Current User

Fetch the Timely user profile for the OAuth-connected identity inside an account. Use the returned id when creating projects that require a users array.

Timely Get Events

Read Timely time entries (events). Omit id to list with optional since/upto date window, user_id, project_id, and page/per_page pagination. Pass id to fetch one entry.

Timely Get Forecasts

Read Timely forecasts (planned tasks). Omit id to list forecasts; pass id to fetch one forecast row.

Timely Get Labels

Read Timely labels (tags for time entries). Omit id to list labels; pass id to fetch one label including child labels.

Timely Get Projects

Read Timely projects. Omit id to list projects (optional filter, offset, limit). Pass id to fetch one project with budget and membership details.

Timely Get Users

Read Timely users in an account. Omit id to list team members (offset/limit pagination). Pass id to fetch one user record.

Timely Upsert Client

Create or update a Timely client. Omit id to POST a new client (name required). Pass id to PUT an update. Clients are create/update only in the Timely API — deactivate inactive clients in the Timely UI.

Timely Upsert Event

Create or update a Timely time entry. Omit id to POST (day, hours, minutes, and project_id required on create). Pass id to PUT a partial update. Optional note, from/to ISO timestamps, and label_ids attach metadata.

Timely Upsert Forecast

Create or update a Timely forecast (planned task). Omit id to POST (project_id required). Pass id to PUT an update. estimated_minutes sets planned duration.

Timely Upsert Label

Create or update a Timely label. Omit id to POST (name required). Pass id to PUT an update. Optional parent_id nests the label under another label.

Timely Upsert Project

Create or update a Timely project. Omit id to POST (name, color, client_id, and users array required on create — users may be an empty array). Pass id to PUT a partial update.