Resource Apps

Resource Apps allow users to import content easily from third-party providers. Unlike the other apps, Resource Apps can only be installed to the Resource section.

Please note:

  • Resource Apps do not have access to the standard API endpoints
  • When you are ready to publish your app, choose app type: Resource App

We have exposed the special endpoints below for Resource Apps. Use the returned import IDs to construct an import URL (see workflow below). Your Resource App will use this URL to redirect the user to a special Schoology import page, where the user can select the desired destination (eg, personal resource, a course …etc).

FieldNameDescriptionTypeRequired
TitletitleThe title of the linkstringyes
UrlurlThe URL of the linkstringyes
Path

POST https://api.schoology.com/v1/content_app/import/link

Content
JSON 
{
  "title": "Schoology Developers",
  "url": "https://developers.schoology.com"
}
XML 
<body>
  <title>Schoology Developers</title>
  <url>https://developers.schoology.com</url>
</body>
Return

An import ID

Import: Embed

FieldNameDescriptionTypeRequired
TitletitleThe title of the linkstringyes
EmbedembedThe embed code of the contentstringyes
Path

POST https://api.schoology.com/v1/content_app/import/embed

Content
JSON 
{
  "title": "Schoology Introduction",
  "embed": "{ ... embed code ... }"
}
XML 
<body>
  <title>Schoology Introduction</title>
  <embed>{ ... embed code ... }</embed>
</body>
Return

An import ID

Import: File

For files, place a file-id inside a file-attachment object located at the first level within the request body. See [Attaching Files, Links, Embeds, and Resources](https://developers.schoology.com/api/upuploading-files

Path

POST https://api.schoology.com/v1/content_app/import/file

Content
JSON 
{
    "file-attachment": {
        "id": [
            213123234
        ]
    }
}
XML 
<body>
  <file-attachment>
    <id>
      <id>213123234</id>
    </id>
  </file-attachment>
</body>
Return

An import ID

Import Workflow

1. User selects content

Use the special endpoints above to import the content into Schoology and retrieve an import ID.

2. Redirect user to Schoology’s import page

Use the import ID to redirect the user to the Schoology Import page, where the user can select the import destination(s) within Schoology. For example, redirect the user to the following URL:

https://app.schoology.com/content_app/import?import_id[]={ ... import id ... }&return_url={ ... your app url ... }

3. Schoology redirects the user to your Resource App

After importing the content to the selected areas, Schoology will redirect the user back to your Resource App. Use the query parameter, return_url, to ensure that the user is redirected to a specific endpoint (eg, display a custom success message upon return).