Hire a candidate

POST

https://api.confirm.global/api/v1/applications/:applicationId/hire

POST

/api/v1/applications/:applicationId/hire

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

1 {
2   "application": {
3     "application_id": "string",
4     "org_id": "string",
5     "candidate_id": "string",
6     "job_id": "string",
7     "status": "applied",
8     "score": 1.1,
9     "applied_at": "2024-01-15T09:30:00Z",
10     "evaluation_status": "string",
11     "evaluation_sent_at": "2024-01-15T09:30:00Z",
12     "evaluation_completed_at": "2024-01-15T09:30:00Z",
13     "candidates": {
14       "candidate_id": "string",
15       "org_id": "string",
16       "first_name": "string",
17       "last_name": "string",
18       "email": "string",
19       "phone": "string",
20       "address_line1": "string",
21       "address_line2": "string",
22       "city": "string",
23       "state": "string",
24       "postal_code": "string",
25       "country": "string",
26       "source": "string",
27       "applications": [
28         null
29       ],
30       "created_at": "2024-01-15T09:30:00Z",
31       "updated_at": "2024-01-15T09:30:00Z"
32     },
33     "created_at": "2024-01-15T09:30:00Z",
34     "updated_at": "2024-01-15T09:30:00Z"
35   }
36 }

Marks the application as hired, with optional congratulations email/SMS.

Authentication

AuthorizationBearer

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

Path parameters

applicationIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.

notestringOptional

send_smsbooleanOptional

sms_bodystringOptional

send_emailbooleanOptional

email_subjectstringOptional

email_bodystringOptional

Response

The hired application.

applicationobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error