Inviting candidate using test link, will copy settings from given test link and apply that to invite. Useful, in case, if you wish to keep same settings for each invitations or segregate invites based on test links for example campus recruitment or remote assessment.
By default, API does not send email to candidate.
Each test link will behave in isolated fashion when inviting same candidate across different testlink of that test. You can invite same candidate (candidate is considered same if email address used is same), in different test link for the same test.
Field | Type | Required | Default | Description |
---|---|---|---|---|
testId | Integer64 | Yes | - | Unique identifier of the test |
testLinkId | Integer64 | Yes | - | Unique identifier of the test link |
Field | Type | Required | Default | Description |
---|---|---|---|---|
String | Yes | - | Email address of candidate | |
name | String | Yes | - | Full name of candidate |
callbackUrl | String | No | - | Receive candidate test completion notification at your mentioned endpoint |
redirectUrl | String | No | - | Redirect candidate to given URL after test completion |
disableMandatoryFields | Integer | No | 0 | When enabled, email and name fields not required. System auto generates random values both fields. |
hideInstruction | Integer | No | 0 | Skips test instruction page |
sendEmail | String | No | no | When enabled sends test invitation email to candidate.By default disabled. Possible values yes/no |
Field | Type | Description |
---|---|---|
testInvitationId | Integer64 | Unique identifier given to each test attempt |
testUrl | String | URL which candidate can access to appear for the test |
URL 1: /v3/tests/{testId}/testlinks/{testLinkId}/invite
Request Body{ "email":"[email protected]", "name":"amey", "callbackURL":"https://www.interviewmocha.com/", "redirectURL":"https://www.interviewmocha.com/", "disableMandatoryFields":0, "hideInstruction":0 }
Status 201 Created
Response{ "testInvitationId": 2807324, "testUrl":"https://test.interviewmocha.com/IMInstructions?bk1kdWNyYXdudzN" }
Status 400 Bad Request
If required parameters have invalid values.
Response{ "errors": [ "'Email' must not be empty.", "Email address is in invalid format" ] }