Step 2: Configure the integration

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.

An integration configuration defines where external content and statistics are imported and how they behave once available in 360Learning. Use the Create an integration configuration endpoint to create it.

Key rules:

Create one integration configuration per group within a customer platform.
To integrate content or statistics into multiple groups or platforms, create separate integration configurations for each.

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.