Skip to main content
These cookbooks walk through complete workflows — from creating an interview to reviewing a candidate’s results — using the JobMojito API. Each recipe lists the exact endpoints, required fields, and a runnable example.
Working through an AI assistant connected to the JobMojito MCP server? Each recipe also names the matching MCP tool (e.g. create_interview), so the same steps apply whether you call the REST API directly or via the MCP.

​
Before you begin

All requests share the same base URL and authentication.
Requests and responses are JSON unless noted. Calls act on behalf of the authenticated merchant user, so results respect that user’s permissions.

​
Recipes

Create an interview

Choose how: generated from a job position, from your own questions, in one call for a candidate, or as a role-play persona; and the template that decides voice or avatar.

Generate an interview from a job position

Let JobMojito write the description, questions and expectations: the create call, its fields, how many questions fit, and every optional setting.

Create a role-play persona

An avatar that plays a role instead of asking questions, for coaching or as an interview role-play: its fields and how the conversation progresses.

Edit interview questions

Read an interview’s question list, change it, and send it back — without disturbing the questions you did not touch.

Invite candidates

Generate signed interview links or send branded email invitations.

Pre-screen candidates

Score a résumé against a position before inviting them to interview.

Review results

List results, read the full transcript and AI assessment, and export reports.

Manage a knowledge base

Upload documents so interviews can ask grounded, knowledge-based questions.

Build a coaching catalogue

Organise the coaching portal into directories, place sessions and personas into them with tags, and author custom directory pages.

Format content with Markdown

The vocabulary for every field that renders as Markdown — headings, tables and code, plus chips, callouts, cards, columns and buttons.

​
Account configuration

Each portal configuration is a JSON document you can import in the admin (Branding & Configuration, or a portal’s pages screen) or send to POST /portal-configuration-update; GET /portal-configuration-get returns the current one.

Branding

Portal name, style, colours, logos, e-mail sender name and speech term boosting, plus the theme CSS that builds on them.

Interview portal

Languages, the classic home page texts, and the support, tracking and completion messages.

Coaching portal

Use case, feature toggles, wording, the coaching plan, languages and the home page blocks.

Portal pages

A whole portal site in one document: pages in every language, the menu, the site footer and the theme CSS.