Reference

List accounts

Retrieve all Timely accounts associated with your profile so you can view and manage multiple business or project accounts in one place.

Retrieve an account

Fetch current account details and information for a specific account ID. Use this to verify account status, balances, and settings at any time.

Get activities

Retrieve a complete audit trail of all activities in your Timely account, including logged hours, reports, project changes, and account events. This helps you track what's been done and who did it across your time tracking and project management.

Get user capacities

Retrieve work capacity and availability information for a specific team member to understand their current workload and scheduling constraints. This helps you allocate projects and tasks based on realistic capacity rather than assumptions.

List clients

Retrieve all clients in your Timely account to find client information, IDs, and names for managing projects and organizing billing relationships.

Create Client

Add a new client to your Timely account for tracking time and billable work against different projects or customers. This helps you organize your timesheet entries by client and manage billing more effectively.

Get Client

Retrieve detailed information about a specific client including their name, status, color coding, and any external references linked to their account.

Update a client

Modify client details like name, status, color, or external ID in your Timely account. Use this to keep client information current and organized as your business relationships evolve.

Create Day Locking

Locks time entries for specific dates and users to prevent any modifications, ensuring data integrity after approval or billing cycles.

Update day locking settings

Prevent accidental changes to completed timesheets by locking or unlocking specific days for selected users, ensuring time tracking data remains accurate and unmodified when needed.

List events

Retrieve all time entries from your Timely account with optional filtering by date, team members, or projects to get a complete view of how time is being spent.

Process bulk events

Submit multiple event create, update, or delete operations simultaneously to save time and reduce API calls when managing large volumes of calendar or scheduling data.

List project events

Retrieves all time entries logged against a specific project, enabling you to review and analyze how your team spent their time on that work.

List user events

Retrieve all time entries logged by a specific user in Timely to review work history, track productivity, and generate reports. This helps you verify time tracking data and analyze how team members or contractors are spending their work hours.

List forecasts

Retrieve all planned tasks and forecasts from your Timely account with optional filtering by date range to track upcoming work and deadlines.

Create Label

Create custom labels in your Timely account to organize and categorize your projects, time entries, and other resources for better tracking and reporting.

Delete a label

Remove an unwanted label from your Timely account to keep your time tracking system organized and clean.

List labels

Retrieve all available labels in your Timely account to discover existing organization categories and their identifiers. Helps you understand your label structure before organizing projects or time entries.

Retrieve a label

Fetch details about a specific label from your Timely account, including its name, color, and relationships to other labels. Use this to verify label properties or retrieve label information for organizing your time tracking data.

Update a label

Modify an existing label's properties such as name, color, or organizational structure within your Timely account. Use this when you need to keep your time tracking categories organized and visually distinct.

Get current user's permissions

Retrieve what actions and access levels the current user has within their Timely account, helping you understand their operational permissions.

Get user permissions

Retrieve the specific permissions and access levels assigned to a user in your Timely account, helping you understand what actions they can perform within your workspace.

List projects

Retrieve all projects from your Timely account to identify project names and IDs for time tracking and billing purposes.

Get project

Retrieve detailed information about a specific project including its name, budget, billable status, and associated client. Use this to access project details whenever you need to verify project settings or gather information for reporting and planning.

Update a project

Modify project details in your Timely account, such as name, description, billing status, or archive status, to keep your project information current and organized.

Create report

Generate customized time tracking and billing reports for your Timely account with optional filters by date range, user, or project to analyze work patterns and costs.

Filter reports

Retrieve and filter Timely reports by date range, users, projects, labels, teams, and billing status to generate custom time tracking analysis. Helps you gain insights into how time is spent across your business and identify billing or project performance trends.

List roles

Retrieve all available roles in your Timely account to understand what permission levels and role types you can assign to team members. This helps you manage access control and permissions across your organization.

Create Team

Create a new team within your Timely account to organize users and improve collaboration on projects. This helps you structure your workforce for better project management and task delegation.

Delete a team

Permanently remove a team from your account when you no longer need it or want to reorganize your team structure.

List teams

Retrieve all teams in your Timely account to see who's available for project assignments and collaboration. This helps you understand your team structure for better resource planning and project delegation.

Retrieve a team

Fetch complete details about a specific team including its name, color scheme, and member list to view team information and composition.

Get current user

Retrieves the profile and account details of the currently logged-in user, allowing you to access identifying information, settings, and preferences associated with the active account.

List users

Retrieve all users in your Timely account to find specific team members for time tracking, reporting, or account management tasks.

Retrieve a user

Fetch user information from your Timely account by user ID, including details like name, email, and profile picture. Use this to verify user accounts or retrieve team member information for reporting and management purposes.

Update a user

Modify user details in your Timely account such as email, name, role, or status to keep team information current and accurate.

Create Webhook

Set up automated alerts that send real-time notifications to your systems whenever specific events occur in your Timely account, enabling seamless integration with other business tools and workflows.

Delete Webhook

Remove a webhook from your Timely account when you no longer need real-time notifications about payment or booking events.

Get Webhook

Retrieve the configuration details and status of a specific webhook to verify its setup and ensure it's properly configured to receive payment notifications.

List Webhooks

Retrieve all webhooks configured in your Timely account to view existing integrations and verify that event notifications are properly set up.

Update Webhook

Modify an existing webhook's configuration, including its target URL, event subscriptions, and active status to ensure it continues to receive the payment notifications your business needs.