Skip to main content
TM
TalentOS
DocsIntegrationsWebhooks

Webhooks

Receive real-time HTTP notifications when events occur on TalentOS. Build custom automations and integrations.

Available Events

Subscribe to any combination of events:

CategoryEventsPayload
Talenttalent.created, talent.updated, talent.verifiedFull talent profile object
Bookingbooking.created, booking.confirmed, booking.completedBooking details + talent + client
Paymentpayment.received, escrow.funded, payout.completedTransaction details + amounts
Contractcontract.sent, contract.signed, contract.expiredContract metadata + signer info
Eventevent.created, scoring.submitted, results.publishedEvent details + scores

Webhook Security

Every webhook delivery is secured with HMAC signing:

Verify Webhook Signature
// Node.js example
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}
HMAC-SHA256 — Every payload is signed with your webhook secret. Verify the X-TalentOS-Signature header
Retry Policy — Failed deliveries are retried 5 times with exponential backoff (5s, 30s, 2m, 15m, 1h)
Idempotency — Each delivery includes a unique event_id. Store processed IDs to prevent duplicate handling