Skip to content

Developers

Your retention signals, in your own systems

A read-only REST API to pull your companies, employees, risk changes and competitors - and webhooks that push employee warnings and poaching opportunities to you the moment they are detected.

Quickstart
curl https://app.teampredict.ai/api/v1/employees \
  -H "Authorization: Bearer tp_your_api_key"

Create an API key in the dashboard under Settings → Developers (admins only). Keys are read-only and shown once.

REST API

Pull everything the dashboard knows

  • Every tracked employee with their latest risk level and profile signals
  • The full feed of detected profile changes, filterable by risk score and date
  • Per-employee change history, exactly as the dashboard shows it
  • Tracked competitors and their people, scored as poaching opportunities
Explore the API reference →

Webhooks

Get pushed the moment something changes

  • Employee warnings the moment a risky change on your roster is detected
  • Poaching opportunities when someone at a tracked competitor looks open to a move
  • A 5-level sensitivity slider per event type, per endpoint
  • HMAC-signed payloads, automatic retries, and a delivery log in the dashboard
Read the webhooks guide →

Example event

One JSON payload, everything you need to act

Every webhook delivery carries the employee, the detected change, the AI risk score and the plain-English summary behind it - enough to post a useful Slack message or open a task without a follow-up API call. The same shape powers both employee warnings and poaching opportunities, so one receiver handles both.

Choose how much you hear with the sensitivity slider: five levels per event type, from Critical only (90%+ risk) to Every signal (20%+). Departures always come through.

employee.warning
{
  "id": "evt_18342_7",
  "type": "employee.warning",
  "createdAt": "2026-07-27T09:14:02.511Z",
  "sensitivityLevel": 3,
  "organization": { "id": 7, "name": "Acme Robotics" },
  "data": {
    "employee": { "id": 123, "name": "Jordan Lee", "title": "Staff Engineer" },
    "change": {
      "changeType": "open_to_work",
      "riskScore": 0.82,
      "riskLevel": "high",
      "summary": "Turned on Open to Work and rewrote their headline."
    }
  }
}

Developer FAQ

Anything that needs your retention and poaching signals where your team already works: pipe risk changes into Slack or Microsoft Teams, sync flagged employees into your ATS or CRM, feed poaching opportunities to your recruiting pipeline, build internal dashboards, or archive change history in your warehouse. The API is read-only, so integrations can fetch everything and break nothing.

Start building in minutes

The API and webhooks are included with every plan and during the free trial. Sign up, add your team, and create a key.