TalentAxis for developers
API and webhooks
Connect TalentAxis to your payroll, HR or internal systems. Read and write applicants with the API, and get a signed webhook the moment an applicant is created, changes status or has an interview.
Authentication
API keys are created by an Owner or Admin in Settings > API & webhooks. The secret is shown once, when you create the key. Copy it then; if you lose it, regenerate the key.
Send the key ID and secret with HTTP Basic authentication on every request:
Authorization: Basic base64(key_id:secret)
curl -u "$KEY_ID:$SECRET" https://hireapi.talentaxis.ai/api/v2/public/applicantsBase URL: https://hireapi.talentaxis.ai/api/v2
Endpoints
All paths are under the base URL above.
GET /public/applicantsList applicants, filtered by job, status or last update, 50 per page.GET /public/applicants/{id}Get one applicant with status, stage type, answers and source.POST /public/applicantsCreate an applicant.PATCH /public/applicants/{external_id}Update an applicant by your external ID.POST /public/applicants/move-statusMove applicants to another hiring status.GET /public/account-locationsList your locations.GET /public/job-hiring-flows/job-idsList your jobs with their hiring flows.
Webhooks
Add an https endpoint in Settings > API & webhooks and choose the events you want. TalentAxis sends a JSON POST for each event.
Events
applicant.createdAn applicant was created.applicant.status_changedAn applicant moved to a new hiring status.interview.scheduledAn interview was scheduled.interview.rescheduledAn interview was rescheduled.interview.cancelledAn interview was cancelled.
Payload
{
"id": "evt_...",
"type": "applicant.status_changed",
"created_at": "2026-11-19T15:04:05Z",
"company_account_id": "...",
"data": {
"applicant_id": "...",
"job_id": "...",
"hiring_status_id": "...",
"hiring_status_name": "Interview",
"stage_type": "OFFER"
}
}Every event has the same envelope. Payloads carry IDs and status only, never a name, phone, email or answers. To get the details, call GET /public/applicants/<applicant_id>.
Verifying signatures
Each delivery has a TalentAxis-Signature header in the form t=<unix timestamp>,v1=<hex>. The value is an HMAC-SHA256 of the string <timestamp>.<raw body>, keyed with your endpoint's signing secret (shown once, when you create the endpoint). Compute it over the raw request body, compare in constant time, and reject the request if t is older than 5 minutes.
Node.js
import crypto from "node:crypto";
// rawBody: the request body exactly as received (Buffer or string)
export function verify(header, rawBody, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const t = Number(parts.t);
if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false; // older than 5 minutes
const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const given = Buffer.from(parts.v1 ?? "", "hex");
const wanted = Buffer.from(expected, "hex");
return given.length === wanted.length && crypto.timingSafeEqual(given, wanted);
}Python
import hashlib, hmac, time
def verify(header: str, raw_body: bytes, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
t = int(parts.get("t", 0))
if not t or abs(time.time() - t) > 300: # older than 5 minutes
return False
signed = f"{t}.".encode() + raw_body
expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts.get("v1", ""))Connect with Zapier or Make
You do not need to write code. Any no-code tool that can receive a webhook and make an HTTP request can use TalentAxis. First create an API key and add a webhook in Settings > API & webhooks, as described above.
Zapier
- Create a Zap and choose Webhooks by Zapier > Catch Hook as the trigger. Copy the hook URL.
- In TalentAxis, add that URL as a webhook, choose your events, and press Send test so Zapier sees a sample.
- Add a Webhooks by Zapier > GET step. Use the URL https://hireapi.talentaxis.ai/api/v2/public/applicants/<applicant_id>, with the applicant_id from the trigger. Set Basic auth to your key ID and secret.
- Send the result to any app you use, such as payroll, your HRIS, Google Sheets or Slack.
Make
- Create a scenario and add a Custom webhook module. Copy its URL.
- In TalentAxis, add that URL as a webhook, choose your events, and press Send test so Make learns the data structure.
- Add an HTTP > Make a request module. Use the URL https://hireapi.talentaxis.ai/api/v2/public/applicants/<applicant_id>, method GET, and set Basic auth to your key ID and secret.
- Connect the result to the next module, such as a spreadsheet, a chat message or your HR system.
Webhooks carry IDs and status only, by design. That is why the second step fetches the applicant with your key. For extra safety, you can check the TalentAxis-Signature header in a code step, as shown in Verifying signatures above.
Retries
Answer with any 2xx within 5 seconds. Otherwise we retry after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours. After 20 consecutive failed events the endpoint is disabled automatically; fix it and enable it again in Settings > API & webhooks. Use the TalentAxis-Event-Id header to ignore duplicates.
Versioning
The API is versioned in the path (/api/v2/). We announce breaking changes ahead of time and add fields without a new version, so ignore fields you do not know.
API reference
The full reference, generated from the live schema.
Loading the API reference...