Getting Started with Ribbon API
A quick start guide to creating your first interview.
🧠 What is Ribbon API?
Ribbon API lets you create intelligent AI-powered voice interviews. To interview someone, all you have to do is share a link.
Ribbon's AI interviewer can hold a natural and intelligent conversation with your interviewee. You can use the Ribbon API to create many types of interviews including: product interviews, surveys, recruitment interviews, health questionnaires, and much more. Use your imagination!
📖 Concepts
Ribbon API has two concepts: Interview Flows and Interviews
Interview Flows are reusable sets of questions and context. They have two types: general
(default) and recruitment
.
Interviews are created from Interviews Flows. Each interview has a one use session link. To interview someone, all you have to do is share the link! Once the interviewee has visited the interview link, the link is expired.
💬 Interview type: General vs. Recruitment
When creating an interview flow, you can choose between two interview types: general
and recruitment
.
general
type interviews
general
type interviewsAll interviews are general
type by default. This is a more generic type of interview suitable for multiple use cases.
recruitment
type interviews
recruitment
type interviewsIf you are screening a potential job candidate, you should use recruitment
type interviews. These interviews are also displayed within the Ribbon platform giving you the opportunity to use Ribbon to view, score, and share the candidates more easily.
🔒 Authentication
Create your first API key on the Ribbon API console page.
When making an API call, add an Authorization header and set the API key as a Bearer Token:
Bearer <your-api-key-here>
You can test your API key by making a call to /ping
🎤 Quick start guide
There are two easy ways to get started depending on the type of interview you want to conduct:
1 ) Conducting a general interview? (suitable for many use cases)
👉 Quick start: conducting general interviews
2 ) Conducting a recruitment interview?
👉 Quick start: conducting recruitment interviews
Updated 20 days ago