Manage Integrations and API Access

Overview

Use this guide to connect integrations, review sync health, and prepare API or webhook workflows.

Goal

Keep Liceo connected to the systems that provide users, apps, licenses, assignments, and usage data.

Before You Begin

• Sign in to Liceo as an admin.
• Confirm which system you want to connect.
• Gather credentials or approval access for the provider.

Step 1 - Open Integrations

1. 1
   Open System in the left sidebar.
2. 2
   Select Integrations.
3. 3
   Review available connectors.

Step 2 - Connect a directory integration

1. 1
   Select Microsoft Entra ID, Okta, or Google Workspace.
2. 2
   Review the requested permissions.
3. 3
   Approve the connection using an admin account.
4. 4
   Return to Liceo.
5. 5
   Start the first sync.
6. 6
   Confirm apps and users appear after sync.

Step 3 - Review integration health

1. 1
   Open System.
2. 2
   Select Integrations or Monitoring.
3. 3
   Check last successful sync time.
4. 4
   Review failed syncs or permission errors.
5. 5
   Reconnect expired credentials if needed.

Step 4 - Configure webhook workflows

1. 1
   Open the webhook or API configuration area.
2. 2
   Create a new webhook endpoint.
3. 3
   Choose the event types to send.
4. 4
   Enter the destination URL.
5. 5
   Save the webhook.
6. 6
   Send a test event if available.
7. 7
   Confirm the receiving system records the event.

Step 5 - Use the API for custom automation

1. 1
   Open API settings or developer settings.
2. 2
   Create or copy an API credential if available.
3. 3
   Store the credential securely.
4. 4
   Build the integration against the approved API endpoints.
5. 5
   Test with a non-production record first.
6. 6
   Monitor errors after launch.

Troubleshooting

Sync fails

Check credentials, provider permissions, and integration health.

Data suddenly drops

Check for revoked permissions, expired credentials, or provider-side changes.

Webhook does not arrive

Check the destination URL, event type, authentication, and receiving-system logs.