Skip to main content
Timely logo
  • Category: time tracking software
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 41
  • Triggers: 0
  • Slug: TIMELY
  • Version: 20261101_00

Tools

Slug: TIMELY_CREATE_CLIENTTool 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.

Input Parameters

string
required
Client name (must be unique within the account).
string
Hexadecimal color code (without ’#’) for the client. Used for visual identification in the Timely UI.
boolean
Whether the client is active. Defaults to true.
integer
Timely account ID where the client will be created. Optional; if not provided, the first accessible account is used.
string
Optional external identifier for syncing with external systems. Use this to map the client to your own system’s ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_CREATE_DAY_LOCKINGCreate day locking entries for specified users and dates in a Timely account, setting them to locked or unlocked. Use this to control time-entry locking after approval or billing.

Input Parameters

integer
Timely account ID to create the day locking for. Optional; if not provided, the first accessible account is used.
object
required
Day property object containing user IDs, dates, and locked status

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_CREATE_LABELTool 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.

Input Parameters

string
required
The name of the label to create.
string
Hex color code for the label without the ’#’ prefix (e.g., ‘1976d2’, ‘00796b’). A random color is assigned if omitted.
integer
Parent label ID for creating hierarchical labels. Omit for top-level labels.
integer
Timely account ID where the label will be created. Optional; if not provided, the first accessible account is used.
string
External identifier reference for integration purposes. Must be alphanumeric, maximum 512 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_CREATE_REPORTTool 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.

Input Parameters

string
Start date for the report period in YYYY-MM-DD format
string
End date for the report period in YYYY-MM-DD format
string
Comma-separated list of user IDs to filter reports by
integer
Timely account ID to generate reports for. Optional; if not provided, the first accessible account is used.
string
Comma-separated list of project IDs to filter reports by

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_CREATE_TEAMTool to create a new team in the specified Timely account. Use when organizing users into teams for better collaboration and project management.

Input Parameters

string
required
Name of the team to create
string
required
6-character hex color code without # symbol for the team (e.g., 1976d2, 00796b, 2e7d32)
array
Array of user IDs to add as members of the team
integer
Timely account ID where the team will be created. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_CREATE_WEBHOOKTool to create a new webhook for the specified account. Use after specifying the target URL and event subscriptions. Call only once per configuration.

Input Parameters

string
required
The HTTPS endpoint that will receive webhook payloads.
integer
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.
string
Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely.
array
required
List of event types to subscribe to for receiving notifications.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_DELETE_LABELTool to delete a label by ID from a Timely account. Use when you need to remove an existing label.

Input Parameters

string
required
The label ID to delete
string
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_DELETE_TEAMTool 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.

Input Parameters

string
required
Team ID to delete
string
Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_DELETE_WEBHOOKTool to delete an existing webhook by its ID. Use when you need to remove a webhook subscription from an account.

Input Parameters

integer
required
The unique identifier of the webhook to delete.
integer
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_FILTER_REPORTSTool 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.

Input Parameters

string
End date for the report filter in YYYY-MM-DD format
string
Start date for the report filter in YYYY-MM-DD format
boolean
Filter by billing status. True for billed hours, False for unbilled hours, None for both.
array
List of team IDs to filter reports by
array
List of user IDs to filter reports by. If not provided, includes all users.
array
List of label/tag IDs to filter reports by
integer
Timely account ID to filter reports for. Optional; if not provided, the first accessible account is used.
array
List of project IDs to filter reports by. If not provided, includes all projects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_ACTIVITIESTool 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.

Input Parameters

integer
Timely account ID to retrieve activities for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_CLIENTTool 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.

Input Parameters

string
required
The client ID to retrieve
string
Timely account ID that contains the client. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_CURRENT_PERMISSIONSRetrieve the authenticated user’s permissions for a specified Timely account to check what actions they can perform.

Input Parameters

string
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_CURRENT_USERTool to retrieve the currently authenticated user. Use when you need to get details of the logged-in user.

Input Parameters

integer
required
Account ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_LABELRetrieve a label by ID from a Timely account, including its name and parent relationship.

Input Parameters

integer
required
The label ID to retrieve
integer
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_PROJECTTool 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.

Input Parameters

integer
required
The project ID to retrieve
integer
required
The ID of the account that owns the project

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_TEAMTool to retrieve details of a specific team by its ID. Use when you need to fetch team information including name, color, and members.

Input Parameters

integer
required
Team ID to retrieve
integer
Timely account ID the team belongs to. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_USERTool to retrieve a user by ID from a Timely account. Use when you need to fetch user details such as name, email, and avatar.

Input Parameters

integer
required
The user ID to retrieve
integer
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_USER_CAPACITIESTool to retrieve capacity information for a specific user in a Timely account. Use when you need to check user work capacity or availability schedules.

Input Parameters

string
required
The user ID to retrieve capacities for
string
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_USER_PERMISSIONSRetrieve a specified user’s permissions in a Timely account by user ID, to check what actions that user can perform.

Input Parameters

string
required
The user ID to retrieve permissions for
string
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_GET_WEBHOOKTool to retrieve a specific webhook by its ID. Use when you need to check the configuration or status of an existing webhook.

Input Parameters

integer
required
The unique identifier of the webhook to retrieve.
integer
Timely account ID the webhook belongs to. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_ACCOUNTSRetrieve all accessible Timely accounts for the authenticated user. Example: “List all Timely accounts”

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_CLIENTSTool 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.

Input Parameters

string ("active" | "archived" | "all")
Filter clients by status: ‘active’ for active clients (default), ‘archived’ for archived clients, or ‘all’ for both
integer
Maximum number of clients to retrieve (default: 10000)
string ("asc" | "desc")
Sort direction: ‘asc’ for ascending or ‘desc’ for descending (default: asc)
integer
Number of clients to skip before retrieving results
integer
Timely account ID to list clients for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_EVENTSList events (time entries) in a Timely account with optional date, user, and project filters. Results are paginated using limit and offset for reporting, analysis, or synchronization.

Input Parameters

string
Comma-separated project IDs to filter events by
string
Comma-separated user IDs to filter events by
integer
Number of results per page (default 50)
string
Start date filter in YYYY-MM-DD format
string
End date filter in YYYY-MM-DD format
integer
Offset for pagination (number of records to skip)
integer
Timely account ID to list events for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_FORECASTSTool 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.

Input Parameters

string
Start date filter (YYYY-MM-DD) to retrieve forecasts from this date onwards
string
End date filter (YYYY-MM-DD) to retrieve forecasts up to this date
integer
Timely account ID to list forecasts for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_LABELSTool 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.

Input Parameters

integer
Maximum number of labels to retrieve
integer
Number of labels to skip before retrieving results
integer
Filter to show only child labels of a specific parent label
integer
Timely account ID to list labels for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_PROJECT_EVENTSTool 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.

Input Parameters

integer
required
The ID of the Timely account
integer
required
The ID of the project to retrieve events for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_PROJECTSTool 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.

Input Parameters

string
Field to sort projects by (default: name)
integer
Maximum number of projects to retrieve
string ("asc" | "desc")
Sort direction: ‘asc’ for ascending or ‘desc’ for descending (default: asc)
string ("active" | "archived")
Filter projects by state: ‘active’ for active projects or ‘archived’ for archived ones
string
Additional filtering options (deprecated parameter)
integer
Number of projects to skip before retrieving results
string
Filter projects by relationship type
integer
Timely account ID to list projects for. Optional; if not provided, the first accessible account is used.
string
Comma-separated list of project IDs to filter by
string
Comma-separated list of external IDs to filter by
string
Retrieve only projects updated after this timestamp (ISO 8601 format or Unix timestamp)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_ROLESTool 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.

Input Parameters

integer
required
Timely account ID to list roles for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_TEAMSTool to list all teams in the specified Timely account. Use when you need to retrieve all teams for collaboration and project management purposes.

Input Parameters

integer
Timely account ID to list teams for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_USER_EVENTSTool 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.

Input Parameters

integer
required
The user ID to retrieve events for
integer
The ID of the Timely account. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_USERSTool 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.

Input Parameters

integer
Number of results per page (default 50)
string ("all" | "active" | "deleted")
Filter options for user list.
integer
Offset for pagination
integer
required
Account ID to list users for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_LIST_WEBHOOKSTool to list all webhooks in the specified account. Use when you need to see existing webhook configurations or verify webhook setup.

Input Parameters

string
Timely account ID to list webhooks for. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_PROCESS_BULK_EVENTSCreate, update, or delete multiple time events in one bulk operation. Each of the create, update, and delete lists supports up to 100 items per request.

Input Parameters

array
Array of event objects to create (max 100 per request)
array
Array of event IDs to delete (max 100 per request)
array
Array of event objects with IDs to update (max 100 per request)
integer
required
Timely account ID to perform bulk operations on

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_RETRIEVE_ACCOUNTTool 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”

Input Parameters

string
required
Identifier of the account to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_CLIENTUpdate an existing Timely client by ID, including its name, status, color, or external ID. The client name is required, and omitted status defaults to active.

Input Parameters

integer
required
The client ID to update
object
required
Client data to update
integer
The ID of the account. Optional; if not provided, the first accessible account is used.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_DAY_LOCKINGTool 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.

Input Parameters

integer
The ID of the account. Optional; if not provided, the first accessible account is used
object
required
Day property object containing locking settings

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_LABELTool to update a label by ID in a Timely account. Use when you need to modify an existing label’s name, color, or hierarchy.

Input Parameters

integer
required
The label ID to update
object
required
Label fields to update
integer
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_PROJECTTool 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.

Input Parameters

integer
required
The project ID to update
object
required
Project data to update
integer
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_USERTool 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.

Input Parameters

integer
required
The user ID to update
object
required
User data to update
integer
required
The ID of the account

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELY_UPDATE_WEBHOOKTool to update an existing webhook by ID. Use when you need to modify webhook settings such as URL, subscriptions, or active status.

Input Parameters

integer
required
The webhook ID to update.
string
The HTTPS endpoint that will receive webhook payloads.
boolean
Whether the webhook is active.
integer
required
The ID of the account the webhook belongs to.
string
Optional secret token used to sign and verify webhook payloads. Set this to validate incoming requests are from Timely.
array
List of event types to subscribe to for receiving notifications.
object
Custom headers to send with webhook requests.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not