Quickstart - intervyo.ai

You’ll set up an evaluation template, get a candidate into an interview, and see a scored transcript within ~2 minutes of them finishing. Pick the path that fits you.

By UI (no code)
By API

The fastest path — for hiring managers, recruiters, and L&D teams who never want to touch an API.

Create a workspace

Pick a template

Open Evaluation Templates and choose a calibrated starter (Software Engineer, Sales Rep, Customer Support…) — or build your own. See Evaluation Templates.

Get a candidate in

Either click Add under Participants to invite someone directly, or share the template’s public apply link and let people apply themselves. Either way they verify by email and the AI interviews them.

Review the scorecard

When the session completes, a full scorecard — per-dimension scores, recommendation, transcript, recording — appears on the participant’s profile. Share it with your panel via a no-login link.

For developers integrating intervyo.ai into your own product or ATS. Full walkthrough: Hiring, step by step.

Get an API key

In the dashboard, go to Developer → API Keys and create a key scoped to candidates.write and interviews.write. See Authentication.

Set up your environment

export INTERVYO_API_KEY="iv_live_…"
export TEMPLATE_ID="ce1cd564-..."   # from your Evaluation Templates page
export TEAM_SLUG="your-team-slug"

Create a participant

Sessions belong to a participant, so create one first.

curl -X POST "https://www.intervyo.ai/api/v1/participants?accountSlug=$TEAM_SLUG" \
  -H "x-api-key: $INTERVYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "evaluation_template_id": "'"$TEMPLATE_ID"'"
  }'

Save the returned id as your candidate_id.

Schedule the session

The invite email is sent automatically.

curl -X POST "https://www.intervyo.ai/api/v1/sessions?accountSlug=$TEAM_SLUG" \
  -H "x-api-key: $INTERVYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_id": "<candidate_id-from-previous-step>",
    "evaluation_template_id": "'"$TEMPLATE_ID"'",
    "stage": "screen",
    "idempotency_key": "quickstart-ada-screen"
  }'

The response includes a join_url (and confirms the invite was emailed).

Receive the scorecard

Configure a webhook to get session.completed the moment the interview ends — or poll GET /api/v1/sessions/{id} until status is completed. Webhooks are strongly preferred; the wait is otherwise unbounded.

What just happened

The AI ran your rubric

Every dimension on the agent profile was scored against the transcript, with per-dimension reasoning and citations.

Authenticity signals captured

Tab-switch, paste, and voice-spoofing signals surface on the dashboard for your judgment — never used to silently reject.

Recording archived

Audio and transcript stored in encrypted, region-aware buckets with presigned access. Retention follows your workspace policy.

Webhook delivered

If configured, your endpoint received the event with the full scorecard, HMAC-signed, with retries on failure.

Next: tune what the AI assesses in your agent profile, or add a second stage so candidates auto-progress on a pass.

​What just happened

The AI ran your rubric

Authenticity signals captured

Recording archived

Webhook delivered

What just happened