Client Portal

The client portal gives your clients a self-service view of their recruiting pipeline — candidates, jobs, interviews, and a messaging inbox.

Dashboard


GET /v1/client-portal/dashboard
Authorization: Bearer <token>

Candidates

List and view candidates presented to the client:


GET /v1/client-portal/candidates
Authorization: Bearer <token>


GET /v1/client-portal/candidates/:id
Authorization: Bearer <token>

Submit feedback

Clients can provide feedback on candidates:


POST /v1/client-portal/candidates/:id/feedback
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "rating": 4,
  "notes": "Strong technical background, would like to proceed to interview"
}

Jobs


GET /v1/client-portal/jobs
Authorization: Bearer <token>


GET /v1/client-portal/jobs/:id
Authorization: Bearer <token>

Interviews


GET /v1/client-portal/interviews
Authorization: Bearer <token>

Inbox and messaging

View the client inbox and send messages on application threads:


GET /v1/client-portal/inbox
Authorization: Bearer <token>


POST /v1/client-portal/inbox/:applicationId/messages
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "message": "Can we schedule this candidate for a second round?"
}

Job requests

Clients can submit new job requests:


POST /v1/client-portal/job-requests
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "title": "Senior Frontend Engineer",
  "description": "We need someone with React and TypeScript experience...",
  "priority": "high"
}