---
title: "Prepare an offer"
method: PUT
path: "/applications/{application_id}/offer"
tags: ["offer"]
---

# Prepare an offer

`PUT /applications/{application_id}/offer`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/applications/{application_id}/offer`
- Auth: HTTP bearer

For a candidate in Offer: first envelope_prepare the offer letter with an officer as signer 1 and the candidate as signer 2, then this with its envelope_id and the values the person gave you (start date, pay, any equity, manager). Never take pay from the job's range. envelope_send then waits for the person's approval; Executed moves the candidate to Hired.

## Path parameters

- `application_id` string, required

## Request body

- object
  - `start_date` string, date, required
  - `pay` object, required
    - `amount` string, required
    - `currency` string, required
    - `period` 'year' | 'hour', required
  - `equity` object, nullable
    - `kind` 'options' | 'rsus' | 'shares', required
    - `number` integer, required
  - `manager` string, nullable
  - `envelope_id` string, required

## Response `200`

The result.

- object
  - `application_id` string, required
  - `envelope_id` string, 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)