For developers

Three ways to build on Lovelio

Every screen in Lovelio runs on the same public API. Post a job, move a candidate through the pipeline, submit a shortlist, log the placement. Build an integration thousands of agencies can connect to, put your own front end on our engine, or hand the whole thing to an AI agent.

Lovelio Connect is in private testing right now. Ask for a demo and we will tell you the day it opens.

27 events to build on17 areas of data3 regionsMCP server for agentsOpenAPI 3.1 specTS + Python SDKs

Things people are building.

Something happens in Lovelio, your software hears about it, does its job, and writes the outcome back to Lovelio.

Background checks

Run the check the moment someone is placed, and put the certificate straight on their record.

placement.createdrun checkdocument on candidate

Skills testing

Send the right test when a candidate reaches your chosen stage. Scores land on the profile before the consultant opens it.

application.stage_changedsend testscore on candidate

Job boards and aggregators

Post every new role automatically, and pipe applicants back in as candidates with their CVs parsed.

job.createdpost to boardapplicants back

Invoicing and accounts

Raise the invoice off the placement fee the second it is logged, with the client and terms already filled in.

placement.createdinvoice in Xeroreference back

Video interviewing

Create the room when the interview is booked. Recording, transcript and summary attach themselves afterwards.

interview.scheduledroom createdtranscript on record

Reference checking

Fire referee requests as soon as an interview goes well, and drop the completed references into the pipeline.

interview.outcome_recordedfollow up with refereesreferences back

Right to work and ID

Verify identity and eligibility at offer stage. The result and its expiry date live on the candidate for the next placement too.

application.stage_changedverifystatus and expiry

Contracts and e-signature

Generate the terms, send them for signature, and attach the signed copy to the placement.

placement.createdsend for signaturesigned PDF back

Timesheets and pay

Everything a temp agency needs to start billing: the placement, the rates, the client, the start date.

placement.status_changedstart the assignment

Messaging

Reach candidates on SMS or WhatsApp when their stage moves, and write the replies back into the timeline.

application.stage_changedmessage sentreply logged

Sourcing tools

Push profiles you find anywhere on the web straight into the right talent pool, deduplicated on arrival.

POST /v1/candidates

Reporting and BI

Stream Lovelio into a warehouse and build the board pack agencies actually want.

analytics and every list endpoint, paged cleanly

Or build the whole front end.

our engine, your screens

A careers site on your own domain

Live jobs, applications with CV parsing, and candidates landing in the pipeline. Your brand, top to bottom.

A client portal

Give clients their own view of the shortlist, interviews and offers, scoped so they only ever see their own roles.

An ATS you designed yourself

Build it in Lovable, Claude Code or Replit. Every endpoint our own product uses is available to yours.

A consultant app for the road

Log a note, move a stage, book an interview from a phone between client meetings.

Commission and performance dashboards

Fees, forecast and billings by consultant, calculated exactly how your business does it.

A feed from your own systems

Push records in from whatever you already run, or drop a folder of CVs and let them parse themselves. Coming off another ATS is a migration we run for you, not an API job.

Let an agent run it.

MCP, built in

Point any MCP client or your own agent at our MCP server and it can run Lovelio properly. It reads the schema, understands the stages, and knows what a submission is. The same permissions apply as they would to a person, and every action lands in the same audit trail.

Nightly rediscovery

Re-run every open role against the whole database overnight and put the new matches in Lovelio by morning.

Inbound triage

Read the applications that arrived, score them against the brief, and shortlist the ones worth a call.

Lovelio from Slack

Ask for a shortlist, send it to the client, book the interview, all from a channel.

Your own agent, your own rules

Give it a key with exactly the access you want it to have and nothing else.

POST /v1/jobs
curl -X POST https://us.lovelio.ai/api/v1/jobs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "title": "Senior Backend Engineer",
    "location": "Remote, UK",
    "client_id": "cli_8h3k2p"
  }'
201 Created
{
  "id": "job_88d10e82",
  "status": "active",
  "careers_page": "live"
}

The sample shows the US base URL. Yours depends on where your workspace lives, and it is on your API keys page.

Read the API reference →

Lovelio Connect.

list your integration, get connected

Building one integration for one agency, your own or a client of yours? You do not need any of this. Ask them for an API key from Settings > API keys in their Lovelio account and call the API directly. Connect is the route when you want OTHER agencies to connect you from the public directory. Everything is self-serve, and you deal with a person only at the last step.

1

Sign in with your work email 30 seconds

Six digit code, no password, and the same code whether you are new or coming back. The first person from your company sets up the workspace and names it inside. Colleagues who join later land in the same place.

2

Take a sandbox agency a few seconds

A complete Lovelio agency, yours to keep: 5 clients, 6 jobs, 18 candidates with real CVs, a pipeline mid-flight, interviews, submissions and placements. It behaves exactly like a paying customer account, and it does not expire.

3

Build against the real thing as long as you like

Same API, same webhooks, same permission checks. Live delivery logs in the portal show you every event as it fires.

4

Describe what you built a minute

One sentence saying what your product does, then two questions: does it write anything back, and does it touch money. We work out the access you need from that, so you never face a list of checkboxes to guess at. Ask for something your answers did not call for and we take a sentence saying why - the reviewer and every agency connecting you reads it.

5

Set up the connect flow a few minutes

Agencies download nothing and set nothing up - they click Connect on your listing and approve, without leaving Lovelio. Your side is two small routes on your own server, and the portal hands you one prompt that your AI coding tool turns into both. You add the two links and the access from step 4. Agencies read that access list word for word on the approve screen, next to your own description of what you do.

6

Run certification about a minute

Sixteen automated checks on your integration: authentication, error handling, pagination, signed webhooks verified end to end, your two links fetched to prove neither is a typo, and the full connect flow exercised against your own sandbox. You get a line-by-line report.

7

Go live in the directory we review by hand

Write your listing, submit, and a human at Lovelio reads it. Approved integrations appear on our public integrations page, where any agency can connect to them.

Read the integration guide →

Built to a standard.

  • ·Server-generated keys, scoped per permission
  • ·HMAC-SHA256 signatures on every webhook
  • ·Idempotency keys on all mutating requests
  • ·Cursor pagination across every list
  • ·Typed IDs you can read at a glance (job_, cnd_, app_)
  • ·Async work returns a task ID you can poll
  • ·Single-file TypeScript and Python SDKs, no dependencies
  • ·A public changelog composed from the spec itself

Build on Lovelio.

Your own sandbox agency, full of real-looking data and behaving exactly like a real one, the day the portal opens. Ask for a demo and we will let you know.