Invite to self-schedule
Email a candidate a link to pick their interview time.
MCP tool comeet_write → invite_to_self_schedule
write Confirm
Does what Schedule > Invite a candidate to select a time does on an interview step. online_meeting is none, zoom or custom_link; custom_link needs the URL, and zoom needs a plan that includes it. The candidate sees your availability at the moment they open the link, and the link expires after 5 days by default. It fails if Auto-scheduling is not configured by an Admin. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate at an interview step. |
| step string required | string | Interview step name. |
| online_meeting enum | enum | none (default), zoom or custom_link. |
| custom_link string | string | Video interview URL for custom_link. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "comeet_write",
"arguments": {
"operation": "invite_to_self_schedule",
"arguments": {
"candidate_id": "cand_3b90e4",
"step": "Interview with hiring manager",
"online_meeting": "custom_link",
"custom_link": "https://meet.example.com/northwind/hm-interview"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": "cand_3b90e4",
"name": "Priya Nair",
"step": "Interview with hiring manager",
"invitation": "sent",
"online_meeting": "custom_link",
"expires_in_days": 5
},
"isError": false
}