Canvas LMS icon

Canvas LMS

Work with Canvas LMS API and receive events

Overview

This node integrates with the Canvas LMS API to retrieve information about a specific enrollment in a course. The "Enrollment: Get" operation fetches detailed data for a single enrollment identified by its Enrollment ID within a specified course.

Typical use cases include:

  • Retrieving enrollment details for a particular student or user in a course.
  • Verifying enrollment status or role of a user in a course.
  • Automating workflows that depend on enrollment information, such as sending notifications or updating records based on enrollment data.

Example: You want to get the enrollment details of a student with a known enrollment ID in a course to check their role or status before performing further actions.

Properties

Name Meaning
Enrollment ID The unique identifier of the enrollment to retrieve. This is required and must be provided as a string.

Output

The node outputs a JSON object under the json field containing a data property. This data property holds the enrollment details returned from the Canvas LMS API for the specified enrollment ID. The structure corresponds to the Canvas API's enrollment resource, typically including fields such as user ID, course ID, enrollment type (role), enrollment state, and other metadata related to the enrollment.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "data": {
    "id": 12345,
    "user_id": 67890,
    "course_id": 11111,
    "type": "StudentEnrollment",
    "enrollment_state": "active",
    "role": "Student",
    ...
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Canvas LMS API.
  • The node expects the base URL of the Canvas instance and an access token to be configured in the credentials.
  • Network connectivity to the Canvas LMS API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Enrollment ID: The node requires a valid enrollment ID; ensure it is correctly provided.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to access enrollment data.
    • Network or API endpoint issues: Confirm that the Canvas LMS URL is reachable and the API is operational.
  • Error messages:

    • "Error in "enrollment" operation "get": ..." indicates a failure during the API request. Check the error message for specifics such as invalid ID or permission denied.
    • "Failed to poll Canvas API" would not apply here since polling is unrelated to this operation but may appear if using triggers.
  • Resolution tips:

    • Double-check input parameters for correctness.
    • Ensure the API token has the necessary scopes/permissions.
    • Review Canvas API documentation for enrollment resource requirements.

Links and References

Discussion