Skip to main content
Classmarker logo
  • Category: education
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 28
  • Triggers: 0
  • Slug: CLASSMARKER
  • Version: 20261101_00

Tools

Slug: CLASSMARKER_CREATE_ACCESS_LIST_ITEMAdds 1–100 access codes to a ClassMarker access list to control exam access. The response can contain an API-level error status.

Input Parameters

array
required
List of access codes to add; up to 100 codes, each up to 255 characters
integer
required
ID of the access list to modify

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_CREATE_CATEGORYCreates a new ClassMarker question category within an existing parent category, using the supplied name and parent category ID. Use it to organize questions by topic.

Input Parameters

string
required
Name for the new category
integer
required
ID of the existing parent category under which this will be created

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_CREATE_GROUPTool to create a new group. Use when you need to organize users into a specific group after planning your user structure.

Input Parameters

string
required
Name of the group to create
string
Optional description for the group

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_CREATE_QUESTIONCreates a question in the ClassMarker question bank with the specified text and category. Supports multiple choice, multiple response, true/false and essay questions.

Input Parameters

integer
required
Points awarded for a correct answer.
object
Answer choices as a dictionary mapping option letters (A-J) to {‘content’: ‘option text’}. Required for multiplechoice, multipleresponse, and truefalse types. Not used for essay questions.
string
required
The text of the question to create.
integer
required
Category identifier to assign this question.
string ("partial_with_deduction" | "partial_without_deduction" | "off")
Grading style for multipleresponse questions: ‘partial_with_deduction’ (partial credit with penalties for wrong choices), ‘partial_without_deduction’ (partial credit without penalties), or ‘off’ (all-or-nothing grading). Only valid for multipleresponse type.
string ("multiplechoice" | "multipleresponse" | "truefalse" | "essay")
required
Type of question to create: ‘multiplechoice’ (one correct answer), ‘multipleresponse’ (multiple correct answers), ‘truefalse’ (True/False question), or ‘essay’ (open-ended text response)
boolean
required
Whether to randomize the order of options. Note: Ignored for truefalse and essay question types.
array
List of correct option letters. Must contain exactly one letter for multiplechoice and truefalse questions, can contain multiple letters for multipleresponse. Not used for essay questions.
string
Optional feedback for a correct answer.
string
Optional feedback for an incorrect answer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_CREATE_USERTool to create a new user in ClassMarker. Use after gathering user details to provision accounts. Provide user info and optional group assignments. Returns the complete API response.

Input Parameters

string
required
User’s email address
boolean
Indicates if the user should have admin privileges
string
required
User’s password, minimum length 8
array
List of group IDs to assign the user to
string
required
User’s last name
string
required
User’s first name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_DELETE_ACCESS_LIST_ITEMRemoves one or more access codes from a ClassMarker access list. Access lists are used to control exam access by requiring users to provide unique identifiers (e.g., email addresses, employee IDs, student numbers). Each code can be used a limited number of times per exam, and codes are recorded with exam results. To use this action: 1. First call GET_ALL_GROUPS_LINKS_EXAMS to find available access list IDs 2. Provide the access_list_id and the list of codes to remove 3. Up to 100 codes can be removed per request Note: This action is idempotent - deleting codes that don’t exist will not cause an error.

Input Parameters

array
required
List of access code strings to remove from the access list. Minimum 1, maximum 100 codes per request. Each code can be up to 255 characters.
integer
required
Numeric ID of the access list to remove codes from. Use GET_ALL_GROUPS_LINKS_EXAMS to find available access list IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_DELETE_API_KEYTool to delete an API key by its ID. Use when you need to revoke an API key immediately.

Input Parameters

integer
required
Unique identifier of the API key to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_DELETE_GROUPTool to delete a group by its ID. Use when you need to remove a group from ClassMarker.

Input Parameters

string
required
ID of the group to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_DELETE_USERTool to delete a specific user by ID. Use when you need to remove a user from ClassMarker after verifying the user’s identity.

Input Parameters

string
required
ID of the user to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_DELETE_WEBHOOKRequest deletion of a ClassMarker webhook configuration by webhook ID. Webhooks are used to deliver exam results to your system in real time; they are managed in the ClassMarker account under Webhooks / API Keys.

Input Parameters

string
required
The unique identifier of the webhook to delete. Note: The ClassMarker API is idempotent and returns success even if the webhook doesn’t exist. Webhook IDs are typically managed through the ClassMarker web interface at My Account > Webhooks / API Keys.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_GROUP_DETAILSRetrieve detailed information about a specific group by ID. Returns group name and assigned tests. Note: This fetches all accessible groups and filters for the specified group_id, as ClassMarker API doesn’t provide a direct single-group endpoint.

Input Parameters

integer
required
Unique identifier of the group to retrieve. Obtain from LIST_GROUPS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_INITIAL_FINISHED_AFTER_TIMESTAMPCompute the initial finishedAfterTimestamp for paginating ClassMarker test results. Use this action when you need to retrieve recent test results for the first time and don’t have a previous ‘next_finished_after_timestamp’ value. This returns a Unix timestamp set to 2 weeks ago, which is the ClassMarker API’s default starting point for result pagination. When to use this: - Starting a new pagination sequence for test results - You don’t have a stored ‘next_finished_after_timestamp’ from a previous request When NOT to use this: - You have a ‘next_finished_after_timestamp’ from a previous response - use that value instead - For subsequent pagination requests - use the timestamp from the last successful response Important: ClassMarker API requires the finishedAfterTimestamp to be less than 3 months old. This action ensures compliance by setting it to 2 weeks ago.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_QUESTIONRetrieves a specific question by ID from the ClassMarker question bank. Use it to inspect the question’s details, including its type, category and available answer options.

Input Parameters

integer
required
Unique identifier of the question to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_RECENT_RESULTS_GROUP_EXAMTool to fetch recent test results for a specific group and exam. Use after determining a UNIX timestamp to retrieve only results finished after that time for the group and exam.

Input Parameters

integer
Number of results to return; default 200; maximum 200.
integer
required
Unique identifier of the test/exam
integer
required
Unique identifier of the group
integer
UNIX timestamp to return only results finished after this time. Defaults to 2 weeks ago if not provided. Must be < 3 months old.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_TEST_DETAILSFind a test’s name and assignment contexts among groups and links accessible to your API key. Returns no_results when the test is not found in those accessible assignments.

Input Parameters

integer
required
Unique identifier of the test (exam) to retrieve. Returns the test name and all contexts (groups/links) where this test is assigned. Use LIST_TESTS to discover available test IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_GET_USER_DETAILSTool to retrieve detailed information about a specific user. Use after you have the user’s ID and need the full user profile.

Input Parameters

integer
required
ID of the user to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_CATEGORIESRetrieves ClassMarker question categories as a hierarchy of parent categories and their sub-categories. Use the category names and IDs to browse and organize questions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_CERTIFICATESTool to list all certificates. Use when you need to retrieve all certificates available in the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_QUESTIONSRetrieve a paginated list of questions from your question bank. Returns up to 200 questions per page. Use the optional ‘page’ parameter to navigate through multiple pages. Each question includes type, content, points, options, correct answers, and metadata.

Input Parameters

integer
Page number to retrieve; defaults to 1 if omitted. Each page returns up to 200 questions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_RECENT_RESULTS_FOR_GROUPSRetrieve recent exam results for groups accessible to your API key, including scores, pass/fail status, and certificate information when available. Results default to the last two weeks or can be fetched from a specified timestamp, normally within three months.

Input Parameters

integer
Number of results to return; default 200; maximum 200.
integer
UNIX timestamp to return only results finished after this time. Defaults to 2 weeks ago if not provided. Must be < 3 months old.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_USERSTool to list all users. Use when you need to retrieve every user in your account after confirming authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_LIST_WEBHOOKSTool to retrieve all configured webhooks. Use when you need to programmatically list your webhook configurations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_PUT_CATEGORYUpdates an existing ClassMarker sub-category’s name and parent category. Use it to rename a sub-category or move it under a different parent.

Input Parameters

integer
required
ID of the sub-category to update
string
required
New name for the sub-category
integer
required
Parent category ID for the sub-category (can be used to move the sub-category to a different parent)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_PUT_PARENT_CATEGORYTool to update an existing parent category. Use after confirming the parent category ID.

Input Parameters

boolean
If true, only validates parameters without updating the category
integer
required
ID of the parent category to update
string
required
New name for the parent category

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CLASSMARKER_PUT_QUESTIONUpdates an existing multiple choice, multiple response, true/false or essay question in the ClassMarker question bank. The question type must match the original; use verify_only to check the changes without applying them.

Input Parameters

integer
required
Points awarded for a correct answer.
object
Map of option letters (A-J) to {‘content’: text}; required for choice and truefalse types.
string
required
The question text.
integer
required
Category identifier for this question.
string ("partial_with_deduction" | "partial_without_deduction" | "off")
Grading style for multipleresponse type only.
integer
required
ID of the existing question to update
boolean
If true, payload is validated without updating; returns status ‘verified’.
string ("multiplechoice" | "multipleresponse" | "truefalse" | "essay")
required
Question type - MUST match the original question’s type (cannot be changed during update). Options: multiplechoice, multipleresponse, truefalse, essay.
boolean
Whether to randomize the order of options (only valid for multiplechoice and multipleresponse types).
array
List of letters for correct options; single value for multiplechoice/truefalse, multiple allowed for multipleresponse.
string
Optional feedback message for correct answers.
string
Optional feedback message for incorrect answers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not