## Introduction

This guide walks you through creating an Iru integration for use with Synqly's Assets Connector.

## Prerequisites

Before you begin, ensure that you have:

- Access to the Iru web app for your organization
- Permissions to create and manage API tokens


## Required User Permissions

| Permissions | Purpose |
|  --- | --- |
| Devices -> Device list | Querying devices |


## Creating an API Token

1. Log in and click on your username (bottom left).
2. Click **Access** and then **API tokens**.
3. Click **Add Token**.
4. Enter a **Name** and **Description** for the API token.
5. Click **Create**.
6. Iru displays a modal with the API token. Click the visibility control to reveal it, or use **Copy Token** to copy it to your clipboard and store it in a safe place. **You will not be able to see the token details again.**
7. Click **Next**.
8. Click **Configure** to set API permissions for this token now, or **Skip** to change them later.
9. After you finish your changes, click **Save**.
10. After you create your **first** token, Iru shows your tenant-specific **API URL**.


### Inspect or modify a token

1. Click on the token.
2. Click **View** to see token details, including permissions. From there you can:
  - Open the **Permissions** tab to edit permissions for the token.
  - Open the **Activity** tab to see events such as: token created, token name changed, and token permissions edited.


## Configuring the Integration

To configure a new Iru Assets integration, provide each of the values as defined below:

| Integration Parameter | Description |
|  --- | --- |
| Secret | The API token you created and copied in the previous steps |
| Base URL | Your tenant-specific API URL from Iru (shown after you create your first token) |


## Additional Resources

- [Generate an API Token](https://support.kandji.io/kb/kandji-api#generate-an-api-token)
- [Iru API](https://support.kandji.io/kb/kandji-api)