Endpoints, credentials, payload formats and error codes are not published
here. Your Exterview contact issues those directly as part of onboarding.
Before you begin
1
Confirm the Darwinbox modules are enabled
Studio, Event Framework and Assessment Provider must be on.
Raise a CSD task if any are missing.
2
Collect your Exterview values
Your Exterview contact issues the connection values and the list of
assessment templates for your tenant. Credentials are issued per customer
and are never reused across tenants.
3
Collect the Darwinbox values
The integration also needs values that only the Darwinbox side can give you,
per tenant. Gather all of them before setup starts: a missing one stops the
integration at a point that looks like a different problem.
4
Check your candidate data
Every candidate needs a valid, unique email address and mobile
number in Darwinbox. Missing either will stop the interview being
scheduled.
5
Whitelist the Exterview domains
Ask your IT or network team to allow
*.exterview.ai and
*.exterview.io through your web proxy, firewall and email gateway.
Both are required: invitation emails are delivered from these domains, and
the interview itself runs on them.Without this, the integration can look configured and still fail. The
webhook may be rejected on the way out, invitation emails may be quarantined
before the candidate sees them, or the interview page may not load for
candidates on the corporate network.One-time setup in Darwinbox
1
Create the webhook configuration
Go to Studio → Event Framework → Webhook Configuration → CREATE. Give it
a name, enter the values Exterview issued you, and leave Use PUT Method
unchecked.
2
Create the assessment provider
Go to Settings → Company → Assessment Providers → CREATE NEW ASSESSMENT
PROVIDER. Name it 
Exterview AI and select the webhook configuration you
just created. Without this, Darwinbox cannot trigger interviews or receive
results.3
Create the custom fields
Go to Settings → Custom Field and tag Display IN = Assessment
Providers. Create 
duration (numeric, in minutes) and interview_type
(dropdown). The field names are case-sensitive and must match exactly.Create the interview_type dropdown options exactly as your Exterview
contact specifies. The values are validated character for character,
including spaces and capitalisation.4
Create and assign the assessments
Go to Settings → Company → Assessments and create one assessment per
Exterview template. Then go to Settings → Recruitment → Assign
Assessment and assign each one to the applicable jobs. Skipping the
assign step is the most common setup mistake. The assessment will not
appear in the hiring workflow without it.
5
Add the assessment stage to the hiring workflow
In the job’s Hiring Workflow, add a stage of type Assessment. Set
No of days to expire. This drives the candidate’s deadline. Choose
Manual evaluation with named evaluators, or Automatic with a cutoff
percentage. Optionally tick Enable Auto Schedule to fire the interview
when the previous stage completes.A typical flow: Shortlisting → Screening → Exterview Assessment → Face
to Face → HR → Offer.
Scheduling an interview
1
Open the candidate
Open the candidate profile, go to the Overview tab, and check the
hiring flow. Confirm the earlier stages are Completed.
2
Click SCHEDULE on the Exterview Assessment stage
The stage shows Pending for scheduling. Click SCHEDULE to open the
modal.
3
Fill the Schedule Assessment modal
Keep the default event name. Choose the Exterview template, add at least one
evaluator, and set the two custom fields: 
duration and
interview_type. interview_type is what decides which of the modes
below the candidate gets. Check the end date meets your SLA.4
Confirm it fired
The stage now shows SCHEDULED with a CANCEL button, and the
candidate is contacted within minutes. If anything was rejected, the message
on screen is Exterview’s, read it, it says what to fix.
duration caps the interview length. It does not change what you are
charged. One completed interview produces one report, charged once at that
report’s credit price, however long the session ran.The rest of this page covers what happens after scheduling, split by mode.
Phone call
The candidate is interviewed over a normal phone call. There is no browser session, no OTP and no screen share.1
The candidate receives a call
Exterview calls the mobile number on the candidate’s Darwinbox record, at
the number and country code held there.
2
The candidate answers the interview by voice
The AI interviewer asks structured questions and the candidate answers out
loud. The call is recorded and transcribed.
3
The call ends
The interview ends when the question set is complete or the candidate hangs
up. Scoring starts immediately.
4
Read the report
Exterview scores the call and returns a Phone Screen report to the
candidate’s Darwinbox record, with the score, the recommendation and the
evidence behind it.
Voice
A voice-only AI interview in the browser. No avatar is shown.1
Invitation email
The candidate receives an email with the role title, an Interview
Deadline and a Join the Interview button. If it is missing, check
Promotions and Spam.
2
Verify by OTP
The page shows the candidate’s registered email address. They click Send
OTP, then enter the 6-digit code. Allow up to 2 minutes for delivery, and
about 60 seconds between resends. Watch for stray spaces when pasting.
3
Share the screen
The browser asks for Entire screen / Window / Tab. Entire screen is
recommended.
4
Take the interview
The session runs as a voice conversation with the AI interviewer. The
candidate answers by voice or chat. The microphone must stay on and the
candidate should not switch tabs. They click End to finish.
5
Read the report
Exterview scores the session and returns an AI Screening report to the
candidate’s Darwinbox record, with the score, the recommendation and the
recording behind it.
Avatar
The full experience, the same as Voice, with an on-screen interviewer avatar.1
Invitation email
As for Voice: role title, deadline, and a Join the Interview button.
2
Verify by OTP
Same OTP step as Voice, send, enter the 6-digit code, resend after about 60
seconds if it expires.
3
Share the screen
Entire screen is recommended. The camera is also required for this mode.
4
Take the interview
The interviewer avatar appears on the left and the candidate on the right,
with the timer at the top. The AI asks structured questions and the
candidate responds by voice or chat. Camera and microphone must stay active
and the candidate should not switch tabs. They click End to finish.
5
Read the report
Exterview scores the session and returns an AI Screening report to the
candidate’s Darwinbox record, with the score, the recommendation and the
recording behind it.
Cancelling
Click CANCEL on the scheduled stage. Only that stage is cancelled, other stages on the candidate are unaffected. Read the confirmation message shown afterwards; it comes from Exterview. Cancelling returns the stage to a schedulable state, so you can schedule again.Common problems
Scheduling was rejected with an error
Scheduling was rejected with an error
Read the message on screen. It is Exterview’s and it names the problem. The
usual causes are a missing candidate email or mobile number, a non-numeric
duration, or an interview_type value that does not match the expected
option exactly, including spaces and capitalisation.The candidate didn't get the invitation
The candidate didn't get the invitation
Ask them to check Promotions and Spam. If the address is wrong, correct it in
Darwinbox and reschedule the stage.
The OTP didn't arrive or was rejected
The OTP didn't arrive or was rejected
Allow up to 2 minutes, then use Resend OTP after about 60 seconds. Pasting
often carries a trailing space, retyping the code by hand fixes most
rejections.
The score or report is missing after the interview
The score or report is missing after the interview
Allow a short sync delay and refresh the candidate page. If it still has not
appeared, contact your Exterview support channel.