---
title: "Record an offer from the ATS"
method: PUT
path: "/hiring/ats/offers/{ats_offer_id}"
tags: ["hiring"]
---

# Record an offer from the ATS

`PUT /hiring/ats/offers/{ats_offer_id}`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/hiring/ats/offers/{ats_offer_id}`
- Auth: HTTP bearer

Ties an offer envelope prepared in Sign to an offer listed by the connected ATS, with the values agreed. The envelope must have an officer signing before the candidate. When it is Executed, the candidate becomes an employee party and the ATS's offer is marked accepted.

## Path parameters

- `ats_offer_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
  - `id` string, required
  - `provider` 'ashby' | 'workable', required
  - `from` string, required
  - `name` string, required
  - `email` string, required
  - `job_title` string, required
  - `start_date` string, nullable, required
  - `pay` object, nullable, required
    - `amount` string, required
    - `currency` string, required
  - `status` string, required
  - `envelope_id` string, nullable, required
  - `written_back_at` string, date-time, nullable, required
  - `writeback_error` string, nullable, 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)