Overview
The Snipe-IT integration enables you to automate IT asset management workflows within your organization. Connect Serval to Snipe-IT to streamline hardware tracking, user assignments, and inventory management programmatically.Key Features
- Manage hardware assets and inventory
- Track asset assignments to users
- Monitor asset status and locations
- Automate asset lifecycle workflows
Common Use Cases
- Automated asset provisioning for new employees
- Asset recovery during offboarding
- Inventory audits and compliance reporting
- Bulk asset updates and maintenance tracking
Snipe-IT Resources
The Snipe-IT API provides access to the following resources within your asset management system:| Resource | Description |
|---|---|
| Hardware | Physical assets like laptops, monitors, and peripherals |
| Users | People who can be assigned assets |
| Locations | Physical locations where assets are deployed |
| Categories | Asset categories for organization |
| Models | Asset models from manufacturers |
| Manufacturers | Companies that produce assets |
| Status Labels | Custom status indicators for assets |
| Companies | Companies for multi-tenant setups |
Prerequisites
Before setting up the Snipe-IT integration, ensure you have:- Admin access to your Snipe-IT instance
- API access enabled (enabled by default in Snipe-IT)
- Your Snipe-IT instance URL
Setup Instructions
Step 1: Generate Your API Key
1
Log in to Snipe-IT
Access your Snipe-IT instance at your organization’s URL (e.g.,
https://your-company.snipeitapp.com or your self-hosted domain)2
Navigate to Manage API Keys
Click on your account dropdown in the top-right corner and select Manage API Keys
3
Create a New API Key
Click Create New Token and give it a descriptive name (e.g., “Serval Integration”)
4
Save Your API Key
Copy the generated API key immediately - it will only be shown once. Store it in a secure location.
Step 2: Configure Integration in Serval
- Navigate to the Integrations page in Serval
- Find Snipe-IT and click Connect
- Enter your configuration details:
Your Snipe-IT instance URL (e.g.,
your-company.snipeitapp.com or your self-hosted domain). Do not include https:// or trailing slashes.Your Snipe-IT API key from Step 1. This authenticates all API requests using Bearer token authentication.
- Click Submit to establish the integration
Integration configured! Serval will verify your credentials and establish the connection.
API Capabilities
The Snipe-IT API allows you to perform the following operations:Hardware Assets
- List, create, update, and delete hardware assets
- Check out assets to users, locations, or other assets
- Check in assets
- Audit assets
- View asset maintenance history
Users
- List, create, update, and delete users
- View user’s assigned assets
- Manage user permissions and groups
Other Resources
- Manage locations, categories, and manufacturers
- Configure status labels and custom fields
- Generate reports and activity logs
- Handle consumables, accessories, and components
Additional Resources
Snipe-IT API Documentation
Complete API reference for all Snipe-IT endpoints
Authentication Guide
Detailed guide on generating and managing API keys
Snipe-IT Documentation
General documentation for Snipe-IT
Need help? Contact [email protected] for assistance with your Snipe-IT integration.