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

# Register team member

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

## Request

- Base URL: `https://api.timesheet.io`
- URL: `https://api.timesheet.io/v1/teams/{teamId}/members`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

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
    - `managerOrOwner` boolean
    - `owner` boolean
    - `manager` boolean
    - `member` boolean
  - `projectRegistrations` TeamMemberProjectRegistrationDto[]
    - `projectId` string
    - `permission` ProjectPermissionDto
      - `role` string
      - `managerOrOwner` boolean
      - `owner` boolean
      - `manager` boolean
      - `member` 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
    - `managerOrOwner` boolean
    - `owner` boolean
    - `manager` boolean
    - `member` boolean
  - `lastUpdate` integer
  - `created` integer
  - `projectRegistrations` TeamMemberProjectRegistrationDto[]
    - `projectId` string
    - `permission` ProjectPermissionDto
      - `role` string
      - `managerOrOwner` boolean
      - `owner` boolean
      - `manager` boolean
      - `member` 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.dev/timesheet/apis/timesheet-api.md) - [All operations](https://skmtc.dev/timesheet/apis/timesheet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timesheet/apis/timesheet-api/revisions/2f6595c95dc4?raw)