Send test

Creates an assessment for a candidate from the selected test. By default, SmallTalk emails the assessment link when email contains a valid address.

POSThttps://app.smalltalk2.me/api/integration/send_test

Request body

Send a JSON object.

Property	Type	Required	Description
test_id	string	required	Test identifier returned by list_tests.
first_name	string	optional	Candidate's first name.
last_name	string	optional	Candidate's last name.
email	string	optional	Candidate's email address. When no_send_email is false, SmallTalk sends the invitation if this value is a valid email address.
profile_url	string	optional	URL to the candidate's application in the organization's system.
callback_url	string	optional	URL notified by POST after the report is generated. See callbacks.
no_send_email	boolean	optional	Defaults to false. When true, SmallTalk does not email the candidate and the organization must deliver test_link.
label	string	optional	Text displayed in the interface.
expire	string	optional	RFC 3339 expiration timestamp. An omitted or past value is replaced with a timestamp 10 days after creation.
on_complete_redirect_url	string	optional	URL that receives the candidate after assessment completion.
proctoring_mode	string	optional	DISABLED or IMAGE_ON_QUESTION. Defaults to DISABLED.

Expiration format

Use an RFC 3339 timestamp:

2026-09-05T12:00:00Z

Proctoring modes

Value	Behavior
DISABLED	Disables proctoring. This is the default.
IMAGE_ON_QUESTION	Captures an image on every question.

Example request

curl -X POST 'https://app.smalltalk2.me/api/integration/send_test' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "test_id": "12345",
    "first_name": "Harry",
    "last_name": "Potter",
    "email": "hpotter@hogwarts.edu",
    "profile_url": "https://example.com/people/17681532",
    "callback_url": "https://example.com/complete"
  }'

Response

Property	Type	Availability	Description
interview_id	string	always	Assessment ID that identifies the candidate assessment for the test_status endpoint.
test_link	string	always	Link to the candidate's assessment.

{
  "interview_id": "o2jn3r",
  "test_link": "https://app.smalltalk2.me/assessment/?id=o2jn3r"
}