alerts4

approvals8

auth2

authentication11

avatars3

calendar13

clients7

countries2

dashboard3

detailed_reports4

exports6

favorites5

feedback2

goals8

groups11

ical3

insights4

invitations4

keys1

me28

mobile1

organizations18

organizations owner4

organizations subscription1

organizations/customer5

organizations/subscription1

organizations/subscription/billing1

organizations/subscription/checkout1

organizations/subscription/promocode2

organizations/subscription/setup_intent1

preferences6

projects15

rates3

reports9

saved_reports3

smail3

status1

subscription30

summary_reports5

tags5

tasks7

time_entries10

time_entries_notes1

timeline3

timezones2

user-invoices3

users7

utils11

weekly_reports3

workspaces14

workspaces/logo3

workspaces/reports/shared1

workspaces/time_entry_constraints1

time_entries

TimeEntries

Creates a new workspace TimeEntry.

post/workspaces/{workspace_id}/time_entries

Request

Base URL
https://localhost:8080/api/v9
Auth
HTTP basic
TypeScript
https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/time_entries/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

workspace_idinteger required

Numeric ID of the workspace

Query parameters

metaboolean

Should the response contain data for meta entities

Request body

billableboolean

Whether the time entry is marked as billable, optional, default false

created_withstring

Must be provided when creating a time entry and should identify the service/application used to create it

descriptionstring

Time entry description, optional

durationinteger

Time entry duration. For running entries should be negative, preferable -1

duronlyboolean

Deprecated: Used to create a time entry with a duration but without a stop time. This parameter can be ignored.

pidinteger

Project ID, legacy field

project_idinteger

Project ID, optional

shared_with_user_idsinteger[]

List of user IDs to share this time entry with

startstring

Start time in UTC, required for creation. Format: 2006-01-02T15:04:05Z

start_datestring

If provided during creation, the date part will take precedence over the date part of "start". Format: 2006-11-07

stopstring

Stop time in UTC, can be omitted if it's still running or created with "duration". If "stop" and "duration" are provided, values must be consistent (start + duration == stop)

tag_actionstring

Can be "add" or "delete". Used when updating an existing time entry

tag_idsinteger[]

IDs of tags to add/remove

tagsstring[]

Names of tags to add/remove. If name does not exist as tag, one will be created automatically

task_idinteger

Task ID, optional

tidinteger

Task ID, legacy field

uidinteger

Time Entry creator ID, legacy field

user_idinteger

Time Entry creator ID, if omitted will use the requester user ID

widinteger

Workspace ID, legacy field

workspace_idinteger

Workspace ID, required

Response

A workspace TimeEntry.

atstring

When was last updated

billableboolean

Whether the time entry is marked as billable

client_namestring

Related entities meta fields - if requested

descriptionstring nullable

Time Entry description, null if not provided at creation/update

durationinteger

Time entry duration. For running entries should be negative, preferable -1

duronlyboolean

Used to create a TE with a duration but without a stop time, this field is deprecated for GET endpoints where the value will always be true.

idinteger

Time Entry ID

permissionsstring[]

Permission list

pidinteger

Project ID, legacy field

project_activeboolean

project_colorstring

project_idinteger nullable

Project ID. Can be null if project was not provided or project was later deleted

project_namestring

server_deleted_atstring nullable

When was deleted, null if not deleted

startstring

Start time in UTC

stopstring

Stop time in UTC, can be null if it's still running or created with "duration" and "duronly" fields

tag_idsinteger[]

Tag IDs, null if tags were not provided or were later deleted

tagsstring[]

Tag names, null if tags were not provided or were later deleted

task_idinteger nullable

Task ID. Can be null if task was not provided or project was later deleted

task_namestring