About iMochaHelpBook a demo
About iMochaHelpBook a demo
  1. Test Invitations
  • Introduction
  • Skills Assessment API
    • API Reference
      • Getting started
      • API Environment
      • Authentication Mechanism
      • Error Code
      • List timezones
    • Test
      • List all tests
      • Retrieve a test
      • Retrieve test settings
      • Update Test Settings
    • Test Invitations
      • Callback notification
      • Invite candidate
        POST
      • Invite candidate by test link
        POST
      • Bulk Invite
        POST
      • Reattempt Test
        POST
      • Cancel Invitation
        POST
    • Test Link
      • List all test links
    • Report
      • Retrieve candidate test report
      • Retrieve candidate test report in PDF
      • Get Reports By TestId
      • Get All Reports
    • Callback API
      • Process Callbacks
      • Retrieve Invites
    • GDPR
      • GDPR Data Masking Service
    • Users
      • Get all business units
      • Create New User
      • Update User
      • Active/ Inactive User
  • Skills Intelligence API
    • Introduction
    • Authentication
    • Employee
      • List employees
      • Get Employee Skills by employeeId
      • Employee Enrollment
      • Get Employee Certificates
      • Update Employee Status
      • Get Employee Assessment Report
    • JobProfiles
      • Get All JobProfiles
      • Get JobProfile with Skills By JobProfileId
      • Create JobCode
    • Taxonomy
      • Get all Taxonomy Skills
    • CareerPath
      • Get Employee Career Path by employeeId
    • Account
      • Get Multichannel Validation Weightages
  1. Test Invitations

Bulk Invite

Developing
POST
/v3/tests/{TestId}/invitations/bulk
This API allows you to send bulk invitations for a specific test in iMocha to multiple candidates at once. Each candidate will receive a unique test invitation link for the specified test. Max 1000 candidates can be invited at a time if you pass more than limit it will be through error.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apiv3.imocha.io/v3/tests//invitations/bulk' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "startDateTime": "2025-11-12T09:00:00Z",
    "endDateTime": "2025-11-15T10:30:00Z",
    "timezoneId": 1720,
    "proctoringMode": "image",
    "candidates": [
        {
            "email": "[email protected]",
            "name": "John Doe"
        },
        {
            "email": "[email protected]",
            "name": "Jane Smith"
        },
        {
            "email": "[email protected]",
            "name": "Alex Taylor"
        }
    ]
}'
Response Response Example
{}
Modified at 2025-11-13 13:57:50
Previous
Invite candidate by test link
Next
Reattempt Test
Built with