Skip to main content
POST
Bulk enroll candidates

Authorizations

Authorization
string
header
required

Organisation API key created in Assess → Developer → API Keys. Format: Bearer ct_live_<your-key> (live) or Bearer ct_test_<your-key> (test). Optional per-key CIDR allowlists return 403 IP_NOT_ALLOWED.

Path Parameters

slug
string
required

Body

candidates
object[]
send_email
boolean
default:true
expires_days
integer
default:7
file
file

Optional multipart CSV with email (+ optional name) columns.

Response

enrolled
any[]
required
skipped
any[]
required
errors
any[]
required
enrolled_count
integer
required
skipped_count
integer
required
error_count
integer
required
Last modified on September 5, 2026