---
title: "Set your booking link"
method: PUT
path: "/hiring/booking-link"
tags: ["hiring"]
---

# Set your booking link

`PUT /hiring/booking-link`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/hiring/booking-link`
- Auth: HTTP bearer

Your Cal.com, Google Calendar appointment page or any https link, which fills {booking_link} in the emails you send. Binderwork never opens it.

## Request body

- object
  - `url` string, uri, nullable, required

## Response `200`

The result.

- object
  - `templates` object, required
    - `received` object, required
      - `subject` string, required
      - `body` string, required
    - `next_step` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_applied` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_interview` object, required
      - `subject` string, required
      - `body` string, required
  - `variables` string[], required
  - `booking_link` string, nullable, required
  - `from` object, required
    - `name` string, required
    - `company` string, required
    - `reply_to` string, required
  - `retention_months` integer, required
  - `other_roles_months` integer, required
  - `careers_intro` string, nullable, required
  - `privacy_notice_url` string, nullable, required
  - `scanner` boolean, required
  - `writer` 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)
