TOtodoist
Workspace

Invite Workspace Users

Changed on

Invites users to a workspace by email.

post/api/v1/workspaces/{workspace_id}/users/invite

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/workspaces/{workspace_id}/users/invite
  • Auth
    none declared

Path parameters

workspace_idinteger required

ID of the workspace

Example:123456

Request body

email_liststring[] nullable

List of user emails to invite to the workspace.

role'ADMIN' | 'MEMBER' | 'GUEST'

Role of the user inside the workspace

app'todoist' | 'comms' | 'automations'

Product name as first-party clients spell it on the wire.

Example request

{
  "email_list": [
    "teammate@example.com"
  ]
}

Response

Successful Response

invited_emailsstring[] required

Emails successfully invited to the workspace.

Example response

{
  "invited_emails": [
    "teammate@example.com"
  ]
}

Changes