Announcing the new Skype Interviews API

Today we’re announcing the availability of Skype Interviews API. Skype Interviews allows interviewers to evaluate candidates through a video call in the browser. No sign-up or downloads required. Skype Interviews’ real-time code editor also makes it a great way to conduct coding interviews.

The Skype Interviews API allows you to programmatically
1. create interview links
2. customize the call, chat, notes & code editor
3. schedule interviews
4. manage positions
… with a super simple REST API.

Say ‘Hello’ to the ‘Interviews World’

Let’s get started by creating your API Key. Go to https://interviews.skype.com/api/get-started and sign-in with your preferred service. After sign-in you should see your Primary API Key listed there.

Get your Skype Interviews API Key in the developer tools settings

Now, let’s create your first Skype Interviews links. Just make a “HTTP Post” request to https://interviews.skype.com/api/interviews with the “skype-apikey” header set to your API key and you’ll get your first Skype Interviews link.

Here’s what the cURL request would look like:

curl https://interviews.skype.com/api/interviews -H 'skype-apikey: YOUR_API_KEY' -d {}

That’s was super easy, right?

Skype Interviews without the code editor

Skype Interviews by default comes with a code editor but we’ve got you covered if you want to use Skype Interviews just for audio/video calling. Our entire API is based on top of a single endpoint and therefore the only thing you have to change to receive a different interview types is your request body.

If we want to disable the code editor, we just simply define this JSON in our request payload.

{
    "capabilities": {
        "codeEditor": false
    }
}

 

If you’re using cURL, the request looks like this:

curl -X POST 
  https://interviews.skype.com/api/interviews 
  -H 'skype-apikey: YOUR_API_KEY' 
  -d '{
    "capabilities": {
        "codeEditor": false
    }
}'

And voila! You can’t see the code editor on the left sidebar anymore when you go to the link!

Skype Interviews with code editor disabled

You can find the full list of customizations around the call, chat, notes and the code editor itself in our documentation.

Change code editor’s list of languages and default language

Customizing the code editor is again super simple. We continue to use our “single-endpoint” principle and customize only the request body.

Let’s say we want to create an interview link for front-end Android developers using C# (Xamarin) or Java with preference for C#. Therefore, we specify the list of languages here and the default language in our request body.

{
    "codingConfig": {
        "codingLanguages": [
            "csharp", 
            "java"
        ],
        "defaultCodingLanguage": "csharp"
    }
}
Skype Interviews’ code editor with custom coding languages.

It’s as easy as that! Again, we provide many more customization options and we highly encourage you to read through our documentation.

Scheduling Skype Interviews

Scheduling Interviews can be a really big hassle. As we described here, recruiters are often swamped in emails and can’t keep up with the all their workload. We wanted to make scheduling simple by doing all the heavy lifting.

Basically, just supply us the contact details of the candidate and the interviewer and we’ll send out a date/time picker for them to align on a suitable time. You can specify who gets to propose the available time slots. Either the candidate or the interviewer.

Let’s schedule an interview and we’ll let the interviewer propose the dates first. We follow the same pattern as before and just adjust our request body to signal Skype Interviews API that we want to schedule an interview with the following people and roles.

{
   "participants" : [
       { name: "Charles Marva", email: "cha*****@microsoft.com", role: "Interviewer" },
       { name: "Ollie Quillen", email: "ollie***@outlook.com", role: "Candidate" }
   ],
   "scheduling" : {
      "duration": 90,
      "mode": "automatic",
      "dateproposing": "Interiewer" 
   }
}

Now the interviewer will receive an email from Skype Interviews asking for a time range that suits him.

The interviewer receives an email about the interview and can propose a few available time slots

The candidate, then receives an email with the time ranges and gets to pick one.

The candidate receives an email about the interview and can select a suitable time slot

At the end, the interviewer and the candidate will receive a calendar event confirming the interview.

 

That’s our short overview of our API. There are many more options and scenarios to check out in our documentation. If you have any question, you can always reach out to us through the chat bubble in your admin dashboard.