Canvas
Direct API import or Common Cartridge download. The API path needs OAuth credentials from a Canvas admin.
Canvas users have two import paths. Pick whichever fits your district's policy.
| Path | What teachers do | IT setup |
|---|---|---|
| API import | Click Import in the Hub. Content appears in their Canvas course. | Canvas admin installs OAuth credentials (~10–15 min) |
| Common Cartridge | Click Download in the Hub. Upload the file in Canvas. | None |
Setting up API import
We send your Canvas admin a secure setup link so credentials never travel through email.
Email [email protected] with your Canvas admin's email (and your Canvas URL if you have it — the admin can also confirm it in the wizard).
We send a one-time setup link to the admin. Valid for 7 days.
Confirm your Canvas URL. The wizard's first step asks the admin to confirm (or enter) the district's Canvas URL — e.g. your-district.instructure.com. This generates the correct Developer Keys link and redirect URI for the next step.
Create the Developer Key. Following the wizard, the admin creates a Developer Key in Canvas at /accounts/1/developer_keys using the values in the next section.
Enter the Developer Key. The admin pastes the resulting Developer Key ID (Client ID) and Secret back into the wizard and submits. That saves the credentials and brings the API integration live — no further action needed from us.
We never see your credentials
Credentials go directly from Canvas into our encrypted store via the wizard. Setup links expire after 7 days; we can issue a new one if needed.
Developer key settings
These are the same values the wizard shows on the "Create Developer Key" step.
| Field | Value |
|---|---|
| Key Name | MCP Resource Hub |
| Owner Email | [email protected] |
| Redirect URI | https://hub.modernclassrooms.org/api/auth/canvas/callback |
| Other fields | Leave as default |
The wizard provides a one-click Open Canvas Developer Keys button and a Copy button for the redirect URI, so you don't have to type either by hand.
Common Cartridge path (no setup)
If your district doesn't want to install OAuth credentials, teachers can still use the Hub. They download a .imscc file and import it via Settings → Import Course Content → Common Cartridge in their Canvas course.
Trade-off: a manual download/upload step, and we can't tell whether the import succeeded on Canvas's side.