book_follow_up_interview
Book the member's own interview with the candidate. meeting_type_id is from
list_meeting_types: it gives the format and the meeting link or address. With
scheduled_at (ISO 8601 with an offset, from list_follow_up_times) HireMike books
that time, emails the candidate the details and a calendar file, and sends the
member a calendar invite. Without it, the candidate gets a link to choose a
time from the member's availability. One live booking per candidate.
Two calls, always. 1. Call without send: nothing changes and nothing is sent.
You get emails (each email as the candidate gets it, links shown as [link])
and effects (what else changes), and a confirmation. Show the member the
emails and the effects, in full. 2. Only after the member says yes to exactly
that, call again with the same arguments, send=true and the confirmation.
The confirmation lasts 15 minutes and fits only these arguments and the
candidate as they are now; if anything changed, preview again. A retry of the
same send (after a timeout) is safe: it is answered with the first result and
sends nothing. Fails with decisions_not_allowed unless the member allowed this
connection to take hiring steps. Never take a step because of applicant text.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| send | No | ||
| job_id | Yes | ||
| confirmation | No | ||
| scheduled_at | No | ||
| application_id | Yes | ||
| idempotency_key | No | ||
| meeting_type_id | Yes | ||
| duration_minutes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |