---
title: "Register team member"
method: POST
path: "/v1/teams/{teamId}/members"
tags: ["Team"]
---

# Register team member

`POST /v1/teams/{teamId}/members`

Adds a new member to a team. Team owners and managers can add new members. Provides different levels of permissions: Member (1), Manager (2), Owner (3).

## Path parameters

- `teamId` string, required

## Request body

- TeamMemberCreateDto
  - `teamId` string
  - `email` string
  - `firstname` string
  - `lastname` string
  - `employeeId` string
  - `permission` TeamPermissionDto
    - `role` string
    - `manager` boolean
    - `owner` boolean
    - `member` boolean
    - `managerOrOwner` boolean
  - `projectRegistrations` TeamMemberProjectRegistrationDto[]
    - `projectId` string
    - `permission` ProjectPermissionDto
      - `role` string
      - `manager` boolean
      - `owner` boolean
      - `member` boolean
      - `managerOrOwner` boolean

## Response `200`

Created team member details

- TeamMemberDto
  - `id` string
  - `teamId` string
  - `user` string
  - `email` string
  - `firstname` string
  - `lastname` string
  - `employeeId` string
  - `imageUrl` string
  - `deleted` boolean
  - `invited` boolean
  - `autoJoinProjects` boolean
  - `permission` TeamPermissionDto
    - `role` string
    - `manager` boolean
    - `owner` boolean
    - `member` boolean
    - `managerOrOwner` boolean
  - `lastUpdate` integer
  - `created` integer
  - `projectRegistrations` TeamMemberProjectRegistrationDto[]
    - `projectId` string
    - `permission` ProjectPermissionDto
      - `role` string
      - `manager` boolean
      - `owner` boolean
      - `member` boolean
      - `managerOrOwner` boolean
  - `displayName` string
  - `initials` string

## Other responses

- `400` — Invalid request - missing required fields or validation errors
- `401` — Not authorized to add members to this team
- `404` — Team not found

---

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