---
title: "Invite Workspace Users"
method: POST
path: "/api/v1/workspaces/{workspace_id}/users/invite"
tags: ["Workspace"]
---

# Invite Workspace Users

`POST /api/v1/workspaces/{workspace_id}/users/invite`

Invites users to a workspace by email.

## Path parameters

- `workspace_id` integer, required — ID of the workspace

## Request body

- Body108b7f01
  - `email_list` string[], nullable — List of user emails to invite to the workspace.
  - `role` 'ADMIN' | 'MEMBER' | 'GUEST' — Role of the user inside the workspace

## Response `200`

Successful Response

- InviteWorkspaceUsersResponse
  - `invited_emails` string[], required — Emails successfully invited to the workspace.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/todoist/apis/todoist-api.md) · [All operations](https://skmtc.net/todoist/apis/todoist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/todoist/todoist-api/revisions/69a962f1578f/schema)