Skip to main content
Connect to Iru using an API token
This guide walks you through creating an API token in Iru and connecting it to Ravenna for device management automation.

Prerequisites

Before you begin, ensure you have:
  • Organization admin access in Ravenna (only organization admins can open Settings > Integrations)
  • Iru account with admin access
  • Access to Iru dashboard settings
  • Your Iru API URL

Setup guide

Create API token in Iru

1

Navigate to API settings

  1. Sign in to your Iru dashboard
  2. Navigate to Settings > Access (or API section)
2

Generate API token

  1. Find the API tokens section
  2. Click Create API Token or Generate Token
  3. Provide a descriptive name (e.g., “Ravenna Integration”)
  4. Select which APIs the token has access to. The minimum required permission for Ravenna is List Devices.
  5. Copy the generated token
The API token is only shown once. Store it securely before closing the dialog.
3

Note your API URL

Your Iru API URL is typically in the format: https://company.api.kandji.ioFind this in your Iru dashboard settings or account information.

Add integration in Ravenna

1

Navigate to integrations

  1. Go to Settings > Integrations
  2. Find Iru in the Device Management section
2

Select Iru

Click Connect on the Iru integration card
3

Configure credentials

Provide the following information:
string
required
Your Iru API URL (e.g., https://company.api.kandji.io)
Find this under Settings > Access in your Iru dashboard.
string
required
The API token you generated in the previous step
4

Complete setup

Click Connect to complete the integration. This will:
  1. Validate the API token
  2. Test connectivity to your Iru server
  3. Verify API permissions
Connecting doesn’t start asset sync. It’s off by default, so turn it on in the next step.
5

Turn on asset sync

  1. In Settings > Integrations, open Iru.
  2. Open the menu on the connection and select Configure.
  3. Under Sync scopes, add Asset, then save. Saving starts the first asset sync right away, unless the integration is paused. After that it runs every 6 hours.
Asset types created by the sync start with no linked workspaces, so link them to a workspace before their assets appear in its Assets tab.

Troubleshooting

Cause: Asset sync is off. It’s off by default, and connecting doesn’t turn it on.Solution:
  • Open Iru in Settings > Integrations, select Configure on the connection, add Asset under Sync scopes, and save. Saving starts a sync right away, unless the integration is paused.
  • If the devices appear in Settings > Organization - Assets but not in a workspace, link the synced asset types to that workspace. See Asset types.
Cause: API token is invalid, expired, or revokedSolution:
  • Verify the token was copied correctly (no extra spaces or characters)
  • Check if the token still exists in Iru Settings > Access
  • Generate a new API token if the current one is invalid
  • Update the token in Ravenna integration settings
Cause: API URL is incorrect or inaccessibleSolution:
  • Verify the URL format matches your Iru instance (e.g., https://company.api.kandji.io)
  • Ensure the URL includes the protocol (https://)
  • Check that your Iru instance is accessible from your network
  • Confirm the URL in your Iru dashboard settings
Cause: Cannot reach Iru API URLSolution:
  • Verify the API URL is correct and accessible
  • Check if your Iru instance is behind a firewall
  • Ensure network connectivity between Ravenna and Iru
  • Verify DNS resolution for the API URL
Cause: API token doesn’t have required permissionsSolution:
  • Verify the API token has appropriate read permissions for devices
  • For workflow actions that modify devices, ensure write permissions are granted
  • Regenerate the token with correct permissions in Iru settings
Cause: Cannot match user to an Iru deviceSolution:
  • Verify the device is enrolled in Iru
  • Check that user assignment information is populated on the device
  • Ensure the user’s email matches the device assignment in Iru
  • Confirm the device is active and reporting to Iru
Last modified on November 18, 2026