Timely

41 tools available

Timely is an automatic time-tracking platform capturing activity across applications, calendars, and devices, creating detailed timesheets for billing or productivity insights

Connect Timely to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Timely's 41 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Timely

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Timely actions 41

Every Timely action below is a callable tool any Definable persona can invoke.

Create Client

Tool 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.

Create Day Locking

Tool 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.

Create Label

Tool 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.

Create report

Tool 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.

Create Team

Tool to create a new team in the specified Timely account. Use when organizing users into teams for better collaboration and project management.

Create Webhook

Tool to create a new webhook for the specified account. Use after specifying the target URL and event subscriptions. Call only once per configuration.

Delete a label

Tool to delete a label by ID from a Timely account. Use when you need to remove an existing label.

Delete a team

Tool 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.

Delete Webhook

Tool to delete an existing webhook by its ID. Use when you need to remove a webhook subscription from an account.

Filter reports

Tool 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.

Get activities

Tool 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.

Get Client

Tool 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.

Get current user's permissions

Tool to retrieve the current user's permissions for a specified account. Use when you need to check what actions the authenticated user can perform.

Get current user

Tool to retrieve the currently authenticated user. Use when you need to get details of the logged-in user.

Retrieve a label

Tool 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.

Get project

Tool 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.

Retrieve a team

Tool to retrieve details of a specific team by its ID. Use when you need to fetch team information including name, color, and members.

Retrieve a user

Tool to retrieve a user by ID from a Timely account. Use when you need to fetch user details such as name, email, and avatar.

Get user capacities

Tool to retrieve capacity information for a specific user in a Timely account. Use when you need to check user work capacity or availability schedules.

Get user permissions

Tool 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.

Get Webhook

Tool to retrieve a specific webhook by its ID. Use when you need to check the configuration or status of an existing webhook.

List accounts

Retrieve all accessible Timely accounts for the authenticated user. Example: "List all Timely accounts"

List clients

Tool 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.

List events

Tool 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.

List forecasts

Tool 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.

List labels

Tool 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.

List project events

Tool 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.

List projects

Tool 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.

List roles

Tool 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.

List teams

Tool to list all teams in the specified Timely account. Use when you need to retrieve all teams for collaboration and project management purposes.

List user events

Tool 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.

List users

Tool 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.

List Webhooks

Tool to list all webhooks in the specified account. Use when you need to see existing webhook configurations or verify webhook setup.

Process bulk events

Tool 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.

Retrieve an account

Tool 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"

Update a client

Tool 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.

Update day locking settings

Tool 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.

Update a label

Tool to update a label by ID in a Timely account. Use when you need to modify an existing label's name, color, or hierarchy.

Update a project

Tool 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.

Update a user

Tool 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.

Update Webhook

Tool to update an existing webhook by ID. Use when you need to modify webhook settings such as URL, subscriptions, or active status.

Frequently asked questions

What can I automate with Timely on Definable?

Anything Timely exposes through its API. Common time tracking software workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 41 Timely tools directly, then chain the result into another integration without you writing code.

How does Timely authentication work?

Timely uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Timely integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 41 Timely tools. You only need a separate Timely subscription if Timely itself charges per seat or per API call.

Is using Timely through Definable secure?

Every call from a persona to Timely is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Timely on Definable?

Sign up for Definable, open the integrations page, find Timely, and connect via OAuth or API key. You can immediately attach Timely to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Timely actions does Definable expose?

Definable exposes all 41 Timely actions as callable tools — including `Create Client`, `Create Day Locking`, `Create Label`, plus 38 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Timely?

Wire it up in minutes. No coding required.

← All integrations