Skip to main content
HireInterviewAIHireInterviewAI
Integrations Platform

Build HireInterviewAI into your hiring stack.

Schedule AI technical interviews straight from your ATS, Slack, or Zapier and sync the per-concept depth report back into your scorecard. It’s async and link-based — no calendar sync, no taxonomy to learn.

Book a Demo Read the API reference
REST API live today Signed webhooks
How it works

Five calls, end to end

HR owns the interview design. Your system just references a position_id and a candidate — you never handle our interview taxonomy.

0

HR builds a Position

A recruiter configures the role in the dashboard — topics, focus areas, interview types, seniority, duration. That config lives on the Position.

1

Your system lists positions

GET the org’s open positions and resolve a position_id. You never touch our interview taxonomy — just reference the id.

2

Schedule an interview

POST { position_id, candidate } from your ATS, Slack, or Zapier. We mint a candidate invite link and return it instantly.

3

Candidate joins by link

They open invite_url in any browser and take the AI interview — async, no calendar sync, no scheduled start time.

4

Report syncs back

When scoring finishes we POST a signed report.generated webhook. Fetch the full per-concept depth report and write it to your scorecard.

You never handle our interview taxonomy. Topics, focus areas, difficulty and duration all live on the Position. You reference a position_id — nothing more.

Why it’s easy

Built to drop into what you already run

No interview engine to operate, no scheduling glue to maintain — just one contract and a report that lands where your team already works.

Async + link-based

No calendar integration, no scheduling handshake. Create an interview, hand the candidate a link, and they take it whenever they’re ready.

One unified contract

A single, stable REST surface plus signed webhooks. Reference a position_id and a candidate — the Position carries every interview detail for you.

Per-concept depth report

Not a pass/fail flag. You get a knowledge-depth fingerprint per concept, ready to drop straight into your ATS scorecard.

Connectors

Pre-built where you work — or build your own

The REST API and webhooks are live today. Pre-built ATS, Slack, and Zapier connectors are on the roadmap — all built on the same contract you can use right now.

Coming soon

ATS

Greenhouse, Lever & Ashby via Merge.dev — schedule from a job and write the depth report onto the candidate scorecard.

Coming soon

Slack

Kick off an interview with a slash command and get the report pushed into a channel the moment it’s scored.

Coming soon

Zapier

No-code triggers and actions to wire interviews into thousands of apps without writing a line of code.

Live

REST API

The full HTTP API + signed webhooks — available today. Everything the pre-built connectors above will be built on.

API reference

The contract, in full

A small, stable REST surface. Base URL https://api.hireinterviewai.com.

Authentication

Authenticate every request with an org API key. Create keys in the dashboard under Settings → Developers (org admins only). The secret is shown once at creation and stored only as a hash — rotate by creating a new key and revoking the old one. Send the key either way:

Authorization: Bearer hia_…X-API-Key: hia_…
Scopes
  • interviews:write

    Schedule new interviews.

  • interviews:read

    List positions and read interview status.

  • reports:read

    Pull scored reports.

Endpoints

  • GET/api/v1/integrations/positionsinterviews:read

    List open, schedulable positions → [{ id, title, seniority, status }]. Config internals are never returned.

  • POST/api/v1/integrations/interviewsinterviews:write

    Body { position_id, candidate: { email, full_name } }. Optional Idempotency-Key header → { id, invite_url, status, … }.

  • GET/api/v1/integrations/interviews/{id}interviews:read

    Fetch a single interview’s current status.

  • GET/api/v1/integrations/interviews/{id}/reportreports:read

    Scored report: overall_score, recommendation, per-concept concept_depth, proctor_flags, … (404 until ready).

Schedule an interview

POST the position reference and candidate. The optional Idempotency-Key header makes a retried create safe — the original response is replayed and no second interview is charged.

POST /api/v1/integrations/interviews
curl -X POST https://api.hireinterviewai.com/api/v1/integrations/interviews \
  -H "Authorization: Bearer hia_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2c1a7e-9b3d-4e6a-8c10-2f4b6d8e0a12" \
  -d '{"position_id":"3f9b...","candidate":{"email":"jane@acme.com","full_name":"Jane Doe"}}'

Webhook

Subscribe to report.generated to be pushed the outcome the moment scoring finishes — no polling. Verify every delivery before trusting it:

Signature verification
X-Signature-256: sha256=HMAC_SHA256(secret, "{X-Webhook-Timestamp}.{body}")
3 retries on non-2xx 2s / 4s / 8s backoff

Response envelope & spec

Every response is wrapped as { success, data, error }. Generate a client or explore the full contract from the OpenAPI spec.

Download the OpenAPI spec

Ready to wire it up?

Book a demo and we’ll provision your org, issue API keys, and walk your team through the integration.

Book a Demo

Book a demo

Tell us about your hiring needs. We'll set up your workspace and share your login — usually within one business day.

  • A guided walkthrough of the platform
  • Your organization configured for you
  • No credit card, no self-serve setup