Status callbacks

Pass a callback_url when you create an assessment. SmallTalk sends a POST request to that URL when the assessment status changes.

We recommend using an HTTPS callback URL to protect data in transit.

{
  "callback_url": "https://example.com/assessment-status"
}

Callback body

The callback identifies the assessment instance:

{
  "interview_id": "123123"
}

The callback is a change notification, not the full result. Use the received interview_id to call test_status and retrieve the current status and result data.

curl 'https://app.smalltalk2.me/api/integration/test_status?id=123123' \
  -H 'Authorization: Bearer <token>'

SmallTalk waits up to 50 seconds for each callback request to complete. If an attempt fails, SmallTalk makes up to two retry attempts.