---
title: "Add a person to Team"
method: POST
path: "/team"
tags: ["team"]
---

# Add a person to Team

`POST /team`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/team`
- Auth: HTTP bearer

Puts an employee, a founder or a contractor on Team: their party, found by email or new, gains the role, with an employment that has their title, start date and work state. Someone already on Team isn't added twice.

## Request body

- object
  - `name` string, required
  - `email` string, email, required
  - `kind` 'employee' | 'founder' | 'contractor'
  - `title` string
  - `start_date` string, date, nullable
  - `work_state` string, nullable

## Response `200`

The result.

- object
  - `party_id` string, nullable, required
  - `member_id` string, nullable, required
  - `name` string, required
  - `email` string, nullable, required
  - `kind` 'employee' | 'founder' | 'contractor', required
  - `title` string, required
  - `start_date` string, date, nullable, required
  - `work_state` string, nullable, required
  - `ended_on` string, date, nullable, required
  - `ended_by` 'resigned' | 'company', nullable, required
  - `source` 'application.hired' | 'added' | 'imported' | 'workspace', required
  - `agreement` object, required
    - `state` 'signed' | 'sent' | 'uploaded' | 'none' | 'not_needed', required
    - `on` string, date, nullable, required
  - `ip` object, required
    - `state` 'signed' | 'sent' | 'uploaded' | 'none' | 'not_needed', required
    - `on` string, date, nullable, required
  - `departure` object, nullable, required
    - `id` string, required
    - `last_day` string, date, required
    - `ended_by` 'resigned' | 'company', required
    - `private` boolean, required
    - `letter` 'signed' | 'sent' | 'draft' | 'none', required
  - `last_change` object, nullable, required
    - `id` string, required
    - `effective_on` string, date, required
    - `letter` 'signed' | 'sent' | 'draft' | 'none', required

## Other responses

- `default`: An RFC 9457 problem.

---

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