---
title: "Send hiring papers"
method: POST
path: "/team/papers"
tags: ["team"]
---

# Send hiring papers

`POST /team/papers`

## Request

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

Sends a person on Team, or a candidate in Offer, their offer letter and CIIAA (or either one) as separate documents with their own envelopes, in one step. Each paper is a confirmed company template, filled from the record and the values given and checked word for word, or a document the company has. An officer signs first for the company and the person second with an emailed code; signatures go on a page after each document. For a candidate, the offer's values are recorded on the application, so the signed offer makes the hire. Pay is typed, never suggested.

## Request body

- object
  - `party_id` string
  - `application_id` string
  - `papers` object[], required
    - `kind` 'offer' | 'ciiaa', required
    - `template_id` string
    - `document_id` string
  - `values` object
    - `title` string
    - `start_date` string, date
    - `pay` object
      - `amount` string, required
      - `currency` string, required
      - `period` 'year' | 'hour', required
    - `equity` object, nullable
      - `kind` 'options' | 'rsus' | 'shares', required
      - `number` integer, required
    - `manager` string

## Response `200`

The result.

- object
  - `envelopes` object[], required
    - `kind` 'offer' | 'ciiaa', required
    - `envelope_id` string, required
    - `document_id` string, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `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)