Step 2: Configure the integration

An integration configuration defines where external content and statistics are imported and how they behave once available in 360Learning.

Key rules:

Target one platform: Create one integration configuration per 360Learning customer platform.
Select a target group: Content will be added to the catalog and library of this target group.
Plan for multi-group access: If you need the content to appear in multiple groups, choose one of these strategies:
- Multiple integrations: Create a separate integration for each group.
- Shared content (Recommended): Create one integration for one target group, then use the bulk API endpoints Add content to catalogs and Add content to libraries to share content across groups. This prevents duplicates and simplifies management of external courses across the platform.

1. Create an integration configuration

🕑
This step needs to be done only once per integration. Once created, the integration configuration will persist, and you can re-use it for future content and/or statistics synchronizations.

Use the Create an integration configuration endpoint.

Example request

curl --request POST \
     --url https://app.360learning.com/api/v2/integrations \
     --header '360-api-version: v2.0' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
      {
        "defaultCompletion": true,
        "defaultProgress": 0,
        "noGroupPropagation": true,
        "externalPlatform": "My Platform",
        "authorId": "507f1f77bcf86cd799439011",
        "groupId": "507f1f77bcf86cd799439011"
      }
      '

Body parameters

defaultCompletion: Whether courses should be automatically marked as completed when launched from 360Learning. If your statistics synchronization frequency is low (for instance, daily), set this to true to avoid blocking learners in linear learning paths.
defaultProgress: The default progress is applied when a course is launched from 360Learning, before any statistics synchronization occurs.
externalPlatform: The name of your platform, which will be displayed to learners on 360Learning. This value must be unique within the target group.
noGroupPropagation: Defines whether imported contents should be propagated to subgroups (false) or not (true).

Example response

If the request is successful, the API returns the newly created integration configuration:

{
  "defaultCompletion": true,
  "defaultProgress": 0,
  "noGroupPropagation": true,
  "externalPlatform": "My Platform",
  "authorId": "507f1f77bcf86cd799439011",
  "groupId": "507f1f77bcf86cd799439011",
  "_id": "507f1f77bcf86cd799439011"
}

⚠️
Save the _id value. You will need it for all subsequent API calls related to importing courses and synchronizing statistics for this integration.

2. Verify the configuration

After creation, call the List integration configurations endpoint to retrieve all configurations for your customer platform. Your new integration should appear in the list with the values provided during creation.

💡
This endpoint is paginated. You might need to iterate through pages to find your integration.