Skip to main content

​
How It Works

The diagram below shows how your system connects with Tidyhire. You can use Tidyhire in two ways:
  • AI Call — The AI calls candidates on their phone.
  • Interview — Candidates receive an email with a link to complete an AI interview.
API Integration Flow

​
1. Setup (One-time)

1

Get your API key

Log in to the Tidyhire Dashboard and create an API key from Settings > API Keys. See Authentication for details.
2

Set up your webhook

Add a webhook URL in your Tidyhire Dashboard so we can send you results. See Webhooks for details.

​
2. AI Call

Use this when you want the AI to call candidates directly.
1

Send the call request

From your system, use the Initiate AI Call API with candidate details and what the AI should talk about. You can also set retry rules, WhatsApp messages, and a schedule time.
2

Candidate receives the call

The candidate gets an AI call on their phone.
3

AI talks to the candidate

The AI follows the script and instructions you provided.
4

Call finishes

The call ends and a report is created.
5

You get the results

Call details, transcripts, and collected data are sent to your webhook URL automatically.

​
3. Interview

Use this when you want candidates to complete an AI interview on their own time.
1

Send the interview invitation

From your system, use the Interview Invite API. The candidate receives an email with a unique interview link.
2

Candidate opens the interview

The candidate clicks the link and starts the interview.
3

AI conducts the interview

The AI asks the questions and tasks you configured.
4

Interview finishes

The interview ends and scores and reports are created.
5

You get the results

Scores and report links are sent to your webhook URL automatically. You can then update the candidate status in your system.
Last modified on May 29, 2026