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:
  • 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:
​
apiUrl
string
required
Your Iru API URL (e.g., https://company.api.kandji.io)
Find this under Settings > Access in your Iru dashboard.
​
apiToken
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

​
Troubleshooting

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

​
Features

Once connected, you can use Iru in workflows and with AI agents:
https://mintcdn.com/ravenna/r0aOrdH5r83ZhSSD/icons/iru.svg?fit=max&auto=format&n=r0aOrdH5r83ZhSSD&q=85&s=7cce2599052bdc76cdfda10bd0e75220

Workflow Actions

Get device info, lock or erase devices, retrieve recovery keys, and more
https://mintcdn.com/ravenna/r0aOrdH5r83ZhSSD/icons/iru.svg?fit=max&auto=format&n=r0aOrdH5r83ZhSSD&q=85&s=7cce2599052bdc76cdfda10bd0e75220

Agent Tools

Enable AI agents to retrieve device information and troubleshoot issues automatically