Skip to main content

Snipe-IT

Snipe-IT is an open-source IT asset management platform for tracking hardware assets, licenses, accessories, consumables, and their assignment to users and locations. The Willow connector talks to your Snipe-IT instance's REST API so agents can look up and manage inventory under your governance policies.

Authentication Types​

Snipe-IT supports 1 authentication method:

  • API Key (Personal Access Token) — a bearer token generated per user in Snipe-IT
    • Pros: Simple to set up, revocable, respects the generating user's permissions
    • Cons: Inherits the permissions of the user who created it — create the token under a dedicated service account with the least privilege required

Configuration​

Before using the connector, you need to configure:

  • Snipe-IT Instance URL — the base URL of your Snipe-IT instance, without a trailing slash (e.g. https://snipe.yourcompany.com). Willow calls the API at {instanceUrl}/api/v1.

Setting up API Key (Personal Access Token)​

  1. Log in to your Snipe-IT instance, ideally with a dedicated service account that has only the permissions you want to expose.

  2. Click your user avatar in the top-right corner and select Manage API Keys (or navigate directly to /account/api).

  3. Click Create New Token.

  4. Give the token a descriptive name (e.g. Willow Integration) and click Create.

  5. Important: Copy the generated personal access token immediately — it is only shown once.

  6. In Willow, paste the token into the API Key field.

  7. Enter your Snipe-IT Instance URL in the Configuration field (no trailing slash).

  8. Click Save Changes.

tip

Snipe-IT API tokens do not expire by default and inherit the permissions of the user who created them. Use a dedicated least-privilege service account and rotate the token periodically.

Common Use Cases​

Asset Management​

  • Look up assets by asset tag, serial number, or free-text search
  • Create, update, and delete hardware assets
  • Check assets out to users, other assets, or locations, and check them back in
  • Audit which assets are assigned to a given user

License & Software Tracking​

  • List and inspect software licenses and their seat allocation
  • See which seats are assigned to which users or assets

Inventory Visibility​

  • Browse accessories, consumables, and components with remaining availability
  • Review reference data such as models, categories, manufacturers, locations, companies, and status labels

Maintenance​

  • List maintenance records (repairs, upgrades) logged against assets

Available Tools​

The connector ships with tools across the following areas:

  • Hardware / Assets — list, get, get by tag, get by serial, create, update, delete, checkout, checkin
  • Users — list, get, list assets assigned to a user
  • Licenses — list, get, list seats
  • Accessories / Consumables / Components — list
  • Reference data — models, categories, manufacturers, locations, companies, status labels
  • Maintenances — list

Troubleshooting​

401 Unauthorized​

Cause: The API token is invalid, revoked, or missing.

Solution:

  1. Generate a new token under Manage API Keys in Snipe-IT.
  2. Update the API Key in Willow and save.
  3. Confirm the token's user still exists and is active.

403 Forbidden​

Cause: The token's user lacks permission for the requested operation.

Solution:

  1. Review the permissions/role of the user that created the token.
  2. Grant the required permissions, or regenerate the token under a user that has them.

Connection or 404 Errors​

Cause: The instance URL is incorrect or unreachable.

Solution:

  1. Verify the URL format: https://snipe.yourcompany.com (no trailing slash, no /api/v1 suffix — Willow appends the API path automatically).
  2. Ensure the instance is reachable from Willow's network.
  3. Confirm you are using the correct protocol (http vs https).

Security Best Practices​

  1. Dedicated service account — create the token under a purpose-built account, not a personal admin login.
  2. Least privilege — grant only the permissions the integration needs.
  3. Rotate tokens — regenerate and replace tokens periodically, and revoke unused ones.
  4. Guardrails — use Willow guards and conditions to gate destructive tools (delete, checkout/checkin, update) as needed.
On this page