Add users to a course catalog via the API

Users can be invited to a course catalog via the Learn365 Admin Center or the Learn365 API.

In this article, we describe how to add a user to a course catalog via the Learn365 API.

To add a user to a course catalog via the Learn365 API, follow these steps:

1. Go to https://api.365.systems/ and make sure you're authorized with the relevant API key.

2. Find the CourseCatalogs section, expand it, find POST /odata/v2/CourseCatalogs({id})/Users with the Add user to the Course Catalog description, and then select Try it out in the top right-hand corner.

3. After you select Try it out, you'll need to complete the parameters:

• id, where you'll need to enter the ID of the course catalog to which you want to add a user.
• Edit Value field, where you'll need to enter the following required parameters. You can find this information in Azure Active Directory (Azure AD) > Users > select the required user. 

{
"LoginName": "string", (replace string with the User principal name from Azure AD).
"DirectoryObjectId": "string", (replace string with Object ID). This parameter is required if there can be users with the same login names in the organization's Azure AD, for example the user was deleted and created again or there are users with the same first and last names.
}

Other parameters are optional. 

4. When ready, select Execute to run the request. 

5. Go to the Responses block to check the results:

• Number 2xx (for example, 202) under Code shows that the request worked correctly.
• In the Response body field, you'll see the result of the request - the user will be added to the target catalog, and they'll be displayed in its Users list with the data taken from the organization's Azure AD (if provided for the user).

The user will be given access to view all course and training plan home pages of the catalog, preventing them from encountering an access denied message from SharePoint when they navigate around the catalog.