---
title: "Invite user to team"
method: POST
path: "/v4/users"
tags: ["v4", "Users"]
---

# Invite user to team

`POST /v4/users`

## Request body

- CreateNewTeamMemberRequest
  - `email` string, email, required — Email to add to team

## Response `201`

Success

- SuccessResponseTeamMember
  - `success` true, required — Flag for it request was successful
  - `data` TeamMember, required
    - `id` union, required — User ID
      - string, uuid
      - string
    - `email` string, required — User email
    - `role` Role, required
      - `id` union, required — Role ID
        - 1 | 2 | 3 | 4 | 5
        - 1 | 2 | 3 | 4 | 5 — Enum for team roles. Can be used interchangeably with TeamRoleId.
      - `name` 'guest' | 'viewer' | 'analyst' | 'admin' | 'embedded_viewer', required — User email
      - `permissions` string[], required — Permissions the role has
    - `inviteStatus` 'active' | 'pending', nullable — 'pending' if the user has been invited but never signed in, 'active' otherwise.
    - `lastSignInAt` string, date-time, nullable — Timestamp of the user's most recent sign-in
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `409` — Resource Conflict
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)