Advance a candidate to interview scheduling

Moves the candidate’s application into interview scheduling, optionally queueing an outbound scheduling call and sending SMS/email with a booking link. The application must be in a reviewable stage.

Authentication

AuthorizationBearer

Supabase-issued user JWT. Send as Authorization Bearer header. Dedicated API keys are planned for a future release.

Path parameters

candidateIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.

applicationIdstringRequiredformat: "uuid"

reasonstringOptional

skip_callbooleanOptional

When true, no outbound scheduling call is queued.

send_smsbooleanOptional

sms_bodystringOptional

send_emailbooleanOptional

email_subjectstringOptional

email_bodystringOptional

send_booking_linkbooleanOptional

Generate a self-service booking link and substitute it into the messages.

Response

Result of the advance action.

successbooleanOptional

stageChangeobjectOptional

callQueuedbooleanOptional

queueIdstring or nullOptional

smsSentbooleanOptional

emailSentbooleanOptional

bookingUrlstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

$	curl -X POST https://api.confirm.global/api/v1/candidates/candidateId/advance \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"applicationId": "string"
>	}'

1	{
2	"success": true,
3	"stageChange": {
4	"from": "string",
5	"to": "string"
6	},
7	"callQueued": true,
8	"queueId": "string",
9	"smsSent": true,
10	"emailSent": true,
11	"bookingUrl": "string"
12	}