Status callbacks

Pass a callback_url when you create an assessment. After the assessment report is generated, SmallTalk sends a POST request with a JSON body to that URL.

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 identifies the completed assessment but does not include the result. Use the received interview_id to call test_status and retrieve the status and result data.

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

Delivery behavior

• The request uses Content-Type: application/json.
• Each HTTP request has a 50-second timeout.
• Delivery makes up to two attempts. If the first attempt returns an error, including a transport failure, the second attempt starts after 10 seconds.
• An HTTP response status does not trigger a retry.