---
title: "Create/invite team user"
method: POST
path: "/v1/account/users/invite"
tags: ["Team Users"]
---

# Create/invite team user

`POST /v1/account/users/invite`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/account/users/invite`
- Auth: HTTP bearer

Creates a new team user with access to the dashboard.

If a password is provided, sets it directly. Otherwise, generates a temporary
password and returns a password reset link that can be sent to the user.

Creates the user account and user document.

## Request body

- object
  - `email` string, email, required: User's email address
  - `password` string: Password (optional - if not provided, a reset link is generated)
  - `first_name` string: First name
  - `last_name` string: Last name
  - `role` 'admin' | 'member': User role (admin or member)

## Response `200`

User created successfully

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `success` boolean
    - `id` string: User ID
    - `email` string
    - `role` string
    - `first_name` string
    - `last_name` string
    - `reset_link` string: Password reset link (only if password not provided)
    - `message` string

## Other responses

- `400`: Invalid request
- `401`: Authentication required or token invalid
- `403`: User limit reached or email already exists

---

[API](https://skmtc.dev/winnr/apis/winnr-api.md) · [All operations](https://skmtc.dev/winnr/apis/winnr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winnr/apis/winnr-api/revisions/a4f960beb1eb?raw)