Integration overview

SmallTalk Assessment automates the language assessment process. The API lets a partner connect that experience to a customer's existing business workflow.

Customer setup

1. The customer creates a SmallTalk account and obtains a token.
2. The partner stores that token in its integration configuration.
3. The partner sends the token in the Authorization header on every API request.

Assessment flow

1. Select a test and candidate.
2. Send the assessment invitation.
3. Provide the returned test_link to the candidate yourself, or use SmallTalk's email delivery.
4. The candidate completes the test on the SmallTalk website.
5. SmallTalk can notify the partner's callback URL when the status changes.
6. The partner requests the latest test status and results.

Base URL

https://app.smalltalk2.me/api/integration

Authentication

Authorization: Bearer <token>

Keep the token on your server. Do not expose it in browser code or commit it to source control.

Core endpoints

Method	Path	Purpose
GET	/list_tests	List tests available to the organization.
POST	/send_test	Create and send a candidate assessment.
GET	/test_status	Read assessment status and results.

Continue with the quickstart or open the API reference.