How do webhooks decide what to send?

Each webhook endpoint has two event types - employee warnings for your own roster and competitor signals for tracked competitors - and each has its own sensitivity slider with five levels, from Critical only (90%+ risk) to Every signal (20%+). Departures are always delivered. Pick a level per endpoint, so a pager integration can stay quiet while a data warehouse hears everything.

How are webhook deliveries secured?

Every delivery is an HTTPS POST signed with your endpoint's secret using HMAC-SHA256, sent in the X-TeamPredict-Signature header. Verify the signature and timestamp before trusting a payload. Failed deliveries retry on a backoff schedule for about a day and a half, and an endpoint that keeps failing is disabled automatically so you can fix and re-enable it.

Do the API and webhooks cost extra?

No. They are included with every TeamPredict subscription and during the free trial. Rate limits apply (120 requests per minute per key), and access pauses if the subscription lapses.

Developers

Your retention signals, in your own systems

A REST API to read and change your companies, employees, risk changes and competitors - and webhooks that push employee warnings and competitor signals to you the moment they are detected.

Read the API reference Webhooks guide

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 unless you grant write access, and are shown once.

REST API

Everything the dashboard does

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 with the same signals
Write too: add or remove people and competitors, and manage your webhooks

Explore the API reference →

Webhooks

Get pushed the moment something changes

Employee warnings the moment a risky change on your roster is detected
Competitor signals when someone at a tracked competitor shows the same kind of change
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 competitor signals, 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."    }  }}

MCP server

Let your AI assistant run the HR calculators for you

TeamPredict runs a free MCP server at https://www.teampredict.ai/mcp. It needs no account and no API key. Claude, ChatGPT, Cursor and other assistants can call 22 of our free calculators and get exact numbers back, each with a link to the calculator page that shows the same result.

Turnover cost, turnover rate, retention rate and the cost of a bad hire
eNPS, full-time equivalents and PTO accrual
Take-home pay and bonus tax for every US state and DC, overtime and severance
Pay raises and hourly to salary conversion
Business days, date math, time zones, time durations and military time

See the free calculators →

In Claude, open Settings, choose Connectors, then Add custom connector, and paste the URL.
In ChatGPT, turn on developer mode under Settings, Connectors, Advanced, then create a connector with the URL.
In Claude Code, run this command:

Claude Code

claude mcp add --transport http teampredict https://www.teampredict.ai/mcp

In Cursor, add this to your mcp.json file:

mcp.json

{  "mcpServers": {    "teampredict": {      "url": "https://www.teampredict.ai/mcp"    }  }}

Developer FAQ

Anything that needs your retention and competitor signals where your team already works: pipe risk changes into Slack or Microsoft Teams, sync flagged employees into your ATS or CRM, feed competitor signals into your market reports, build internal dashboards, or archive change history in your warehouse. You can also write: have your HRIS add every new hire to tracking automatically, and untrack leavers the day they go.

Both, and you choose per key. Every key can read; only a key an admin creates with write access can add or remove people, competitors and webhooks, so a leaked read key cannot change anything or spend a cent. Write keys cannot run up a bill either: added seats are charged to your card in batches of ten, so no more than about $50 of additions is ever unbilled, and if that charge is declined no further people can be added until the card is fixed. A company still on the free trial can never track more than 100 people at all.

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.

Start Your Free Trial