Step 1: Obtain API v2 credentials

To get started with the API, the first thing you'll need to do is obtain your API credentials.

API credentials are essential for identifying and authenticating your application when requesting an access token. They consist of:

• A client ID: A unique identifier for your application.
• A client secret: A confidential key associated with the client ID. Keep this secure.

Together, these credentials secure communication between your application and the API, ensuring that unauthorized access is prevented.

💡

Each company can have a maximum of 10 API credentials.

Create API v2 credentials

👤

Only platform admins and platform owners can create API v2 credentials. If you're not a platform admin, please share this page with one to request the creation of your API credentials.

1. Log in ↗ to your 360Learning account.
2. In the left sidebar, click on the platform group (with the golden crown at the bottom right of its icon).
3. At the top right of the main section, click Settings.
4. In the left sidebar, click API v2.
5. Click + Add API Credentials.
6. In the dialog box, enter a Credentials label.
   • 💡 Use a descriptive label that reflects the specific integration or use case (e.g., "HR Integration - Payroll System" or "Marketing Analytics Sync"). This will help you quickly identify which credentials are associated with specific integrations.
   • ⚠️ Avoid generic labels like "API Keys" to prevent confusion when managing multiple credentials.
7. Under Permissions, select the scopes you want your API credentials to have from the available company-level options. For more information, see Scopes and permissions.
   1. You can find the permissions required for each endpoint in the API reference.
   2. If a scope you need isn’t visible, it may not be enabled at the company level. Contact your CSP to change the list of scopes available at the company level, if necessary.
8. Click Save.
9. Click Copy client secret to copy your client secret to your clipboard. Make sure to store it in a safe place.
   ⚠️ The client secret is only visible once when the credentials are created.
10. Copy the client ID.
    💡 The client ID can be found on the API Credentials screen in the admin board after the credentials have been created. You can copy it at any time.
11. Click Close.