Xurrent Integration Summary

Quick Reference

Configuration Requirements

1. API Token with scopes: configuration_items:read, configuration_items:write
2. Account ID from Xurrent
3. Default Support Team ID (required)
4. Product Mappings for each CI Type

What Syncs

• CIs: Name, Description, Status, Serial Number, Custom Fields
• Relationships: Parent/Child, Dependencies, Network Connections
• Not Synced: Attachments, Comments, History

When It Syncs

• Manual Only - No automatic sync currently
• Triggered via Export button in UI
• Processes CIs marked with needsXurrentSync flag

Key Data Mappings

KILLIT	Xurrent	Required
CI Name	name/label	Yes
CI Type	Product (via mapping)	Yes
Status	status (mapped)	Yes
Description	remarks	No
Serial Number	serialNr	No
Custom Fields	customFields	No

Status Mapping

• active → in_production
• inactive → archived
• maintenance → undergoing_maintenance
• removed → removed

Common Issues

1. Missing Product Mapping: Configure in UI
2. No Support Team: Set Default Support Team ID
3. API Permission Error: Check token scopes
4. CI Not Found: Name mismatch or not synced yet

API Endpoints

POST /api/integrations/xurrent/config         # Save config
POST /api/integrations/xurrent/test-connection # Test connection
POST /api/integrations/xurrent/export         # Export CIs

Export Options

{
  "ciType": "Server",      // or "all"
  "batchSize": 50,         // default: 50
  "dryRun": false,         // test without creating
  "filter": {}             // custom filters
}