Skip to main content

Organization

POST Create organization group

https://focus.toggl.com/api/organizations/{organization_id}/groups

Creates a group under an organization for the given users and workspaces.

curl -X POST https://focus.toggl.com/api/organizations/{organization_id}/groups \
-H "Content-Type: application/json" \
-d '\{"emoji":"string","name":"string","organization_users":[\{\}],"workspaces":[\{\}]\}' \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID

Body

NameTypeDescription
emojistring-
namestring-
organization_usersArray of integer-
workspacesArray of integer-

Response

201

Successful operation

400

Invalid request

403

User does not have access

500

Server error

GET Get current user's groups

https://focus.toggl.com/api/organizations/{organization_id}/groups/me

Get groups the current user belongs to

curl  https://focus.toggl.com/api/organizations/{organization_id}/groups/me \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID

Response

200

NameTypeDescription
itemsArray of object-
items
NameTypeDescription
emojistring-
idinteger-
namestring-

400

Invalid request

403

User does not have access to the organization

500

Server error

PUT Update organization group

https://focus.toggl.com/api/organizations/{organization_id}/groups/{group_id}

Updates a group under an organization.

curl -X PUT https://focus.toggl.com/api/organizations/{organization_id}/groups/{group_id} \
-H "Content-Type: application/json" \
-d '\{"emoji":"string","name":"string","organization_users":[\{\}],"workspaces":[\{\}]\}' \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID
group_idintegertruegroup ID

Body

NameTypeDescription
emojistring-
namestring-
organization_usersArray of integer-
workspacesArray of integer-

Response

200

NameTypeDescription
created_atstring-
deleted_atstring-
emojistring-
idinteger-
namestring-
organization_idinteger-
updated_atstring-
usersArray of object-
workspacesArray of object-
users
NameTypeDescription
created_atstring-
deleted_atstring-
display_namestring-
focus_role_idinteger-
organization_user_idinteger-
track_role_idinteger-
updated_atstring-
user_account_idinteger-
user_group_idinteger-
work_role_idinteger-
workspaces
NameTypeDescription
created_atstring-
deleted_atstring-
namestring-
updated_atstring-
workspace_group_idinteger-
workspace_idinteger-

400

Invalid request

403

User does not have access

404

Group not found

500

Server error

DELETE Delete organization group

https://focus.toggl.com/api/organizations/{organization_id}/groups/{group_id}

Deletes a group from an organization.

curl -X DELETE https://focus.toggl.com/api/organizations/{organization_id}/groups/{group_id} \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID
group_idintegertruegroup ID

Query

nametyperequireddescription
workspace_idintegertrueworkspace ID (required for permission check)

Response

200

Successful operation

400

Invalid request

403

User does not have access

404

Group not found

500

Server error

GET Get organization roles

https://focus.toggl.com/api/organizations/{organization_id}/roles

Get organization roles

curl  https://focus.toggl.com/api/organizations/{organization_id}/roles \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID

Response

200

NameTypeDescription
itemsArray of object-
items
NameTypeDescription
codestring-
descriptionstring-
entitystring-
namestring-
organization_idinteger-
permissionsArray of object-
privilege_levelinteger-
role_idinteger-
typestring-
permissions
NameTypeDescription
conditionstring-
descriptionstring-
entitystring-
namestring-
permission_idinteger-

400

Invalid request

403

User does not have access to the organization

500

Server error

GET Get organization teams with ghost IDs.

https://focus.toggl.com/api/organizations/{organization_id}/teams

Gets groups for a workspace, checking view_user_groups permission. Hydrates with local ghosts if any.

curl  https://focus.toggl.com/api/organizations/{organization_id}/teams \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID

Query

nametyperequireddescription
workspace_idintegertrueworkspace ID (required for permission check)
pageintegerfalsepage number
per_pageintegerfalseresults per page
sort_dirstringfalseDirection to sort by (asc/desc)
filterstringfalseFilter by name
organization_user_idintegerfalseFilter groups that contain this organization user
group_ids[]integerfalseFilter by group IDs

Response

200

NameTypeDescription
dataArray of object-
pageinteger-
rowsinteger-
totalinteger-
data
NameTypeDescription
created_atstring-
deleted_atstring-
emojistring-
ghostsArray of object-
idinteger-
namestring-
organization_idinteger-
updated_atstring-
usersArray of object-
workspacesArray of object-
ghosts
NameTypeDescription
idinteger-
namestring-
users
NameTypeDescription
created_atstring-
deleted_atstring-
display_namestring-
focus_role_idinteger-
organization_user_idinteger-
track_role_idinteger-
updated_atstring-
user_account_idinteger-
user_group_idinteger-
work_role_idinteger-
workspaces
NameTypeDescription
created_atstring-
deleted_atstring-
namestring-
updated_atstring-
workspace_group_idinteger-
workspace_idinteger-

400

Invalid request

403

User does not have permission to view groups

500

Server error

GET Get organization users

https://focus.toggl.com/api/organizations/{organization_id}/users

Proxies to accounts organization users endpoint with guest scoping. Guests only see users who share projects with them.

curl  https://focus.toggl.com/api/organizations/{organization_id}/users \
-H "Content-Type: application/json" \
-u <email>:<password>

Parameters

Path

nametyperequireddescription
organization_idintegertrueorganization ID

Query

nametyperequireddescription
workspaces[]integerfalseFilter by workspace IDs
user_account_ids[]integerfalseFilter by user account IDs
org_user_ids[]integerfalseFilter by organization user IDs
groups[]integerfalseFilter by group IDs
toggl_products[]stringfalseFilter by toggl products
active_status[]stringfalseFilter by active status
roles[]integerfalseFilter by roles
only_adminsbooleanfalseOnly return admins
filterstringfalseFilter by name or email
sort_dirstringfalseSort direction (asc/desc)
pageintegerfalsePage number
per_pageintegerfalseResults per page
tag_ids[]integerfalseFilter by tag IDs
include_working_hoursbooleanfalseInclude working hours in response
include_ratesbooleanfalseInclude user rates data for each user
pinned_ids[]integerfalsePin specific users at the top (respects array order)

Response

200

NameTypeDescription
itemsArray of object-
items
NameTypeDescription
2fa_enabledboolean-
account_locked_atstring-
activeboolean-
adminboolean-
can_edit_personal_detailsboolean-
created_atstring-
deleted_atstring-
emailstring-
groupsArray of object-
idinteger-
invite_sentboolean-
joinedboolean-
namestring-
organization_idinteger-
ownerboolean-
permissionsobject-
rateobject-
tagsArray of object-
updated_atstring-
user_account_idinteger-
user_idstring-
working_hoursnumber-
workspacesArray of object-
groups
NameTypeDescription
emojistring-
idinteger-
namestring-
workspace_idsArray of integer-
permissions
rate
NameTypeDescription
currencystring-
end_atstring-
hourly_ratenumber-
start_atstring-
workspace_idinteger-
workspace_rate_idinteger-
workspace_user_rate_idinteger-
tags
NameTypeDescription
colorstring-
idinteger-
labelstring-
workspaces
NameTypeDescription
focus_role_idinteger-
groupsArray of object-
idinteger-
namestring-
toggl_productsArray of string-
track_role_idinteger-
work_role_idinteger-
workspace_user_idinteger-
groups
NameTypeDescription
emojistring-
idinteger-
namestring-

400

Invalid request

403

User does not have access to the organization

500

Server error

© 2026 Toggl. All rights reserved.