SK People Developers Portal — Quickstart, APIs, and Webhooks

Quickstart Integration

Initiate actions securely in three simple steps. Authenticate requests using Platform-signed delegated JWT tokens.

$ curl -X POST https://api.softknack.com/v1/people \
  -H "Authorization: Bearer <delegated_JWT>" \
  -H "Content-Type: application/json" \
  -d '{"org_id": "org_01"}'

import axios from 'axios';

const response = await axios.post('https://api.softknack.com/v1/people', {
  org_id: 'org_01'
}, {
  headers: { Authorization: 'Bearer <delegated_JWT>' }
});

import requests

response = requests.post(
    'https://api.softknack.com/v1/people',
    json={"org_id": "org_01"},
    headers={"Authorization": "Bearer <delegated_JWT>"}
)

Event System

Webhook Subscription Catalog

Ingest events in real time. All webhooks conform to the standard Nexus payload format and contain an HMAC signature key.

Event Type	Description
`people.employee.hired`	Fires when a new profile record commits to the directory.
`people.employee.terminated`	Fires when offboarding checklists finalize, locking profile access.
`people.leave.requested`	Fires when a leave transaction request posts to the ledger.
`people.leave.approved`	Fires when a manager signs off and details are written to the database.
`people.attendance.logged`	Logs checking in or out events with geo-coordinates verification.
`people.asset.assigned`	Fires when hardware serial keys bind to a user record.