Book an interview slot

Books an interview slot. The response is identical for a matched vs unmatched candidate (no existence oracle); the candidate join link is delivered by email, never in the response. Rate-limited per (jobId, IP) and per email per day.

Path Parameters

jobId*string

stageId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

email*string

The candidate's email. The join link is emailed here.

Formatemail

name?string

The candidate's display name, if known.

slotStart*string

The chosen slot start (from an availability slot's start).

Formatdate-time

slotEnd?string

The chosen slot end, if known.

Formatdate-time

timezone?string

The candidate's IANA timezone (e.g. "America/New_York").

Response Body

`application/json`

curl -X POST "https://example.com/scheduling/string/string/bookings" \  -H "Content-Type: application/json" \  -d '{    "email": "user@example.com",    "slotStart": "2019-08-24T14:15:22Z"  }'

{  "data": {    "confirmed": true  }}

Path Parameters

Request Body

Response Body

200application/json

400application/json

404application/json

409application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`