Book an interview
bookInterviewBook the candidate's next interview round with the hiring manager at a time from listInterviewSlots. The hiring manager and the candidate both get a calendar invite, so the candidate gets one confirmation first. Only book a time the candidate picked. outcome booked: done. pending: the scheduler confirms within minutes, so don't call it booked yet. handoff: send the candidate handoffUrl to finish it themselves.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"opportunityId": "<opportunityId>",
"start": "<start>",
"timeZone": "<timeZone>"
},
"name": "bookInterview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start | Yes | One start exactly as listInterviewSlots listed it. | |
| answers | No | The candidate's answers to the booking form's open questions, keyed by each question's slug. | |
| timeZone | Yes | The timezone exactly as listInterviewSlots named it. | |
| eventTypeSlug | No | The meeting type's slug, as listInterviewSlots listed it. | |
| opportunityId | Yes | The opportunityId of a process row from listMyPipeline. | |
| confirmBooking | No | Only when your client cannot show the confirmation prompt: "confirm" once the candidate has said yes to this role and time, "cancel" otherwise. Never set it on your own. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | ||
| label | Yes | ||
| start | Yes | ||
| outcome | Yes | ||
| handoffUrl | Yes | ||
| meetingUrl | Yes |