VICIdial API Integration Examples

Originally published at vicistack.com . Follow us for more call center engineering content. Last updated: March 2026 | Reading time: ~28 minutes VICIdial has two APIs that most people know exist but few people use well. The Non-Agent API handles backend automation — pushing leads, pulling reports, scheduling callbacks. The Agent API controls what happens on the agent screen — pausing, dialing, transferring, dispositioning. Together, they let you build practically anything on top of VICIdial: CRM integrations, real-time dashboards, automated lead routing, web-to-lead forms, callback scheduling systems, and custom reporting pipelines. The official documentation (NON-AGENT_API.txt and AGENT_API.txt) is thorough but written in the style of a 2008-era Unix man page — technically complete, practically incomprehensible if you're just trying to add a lead from a web form. So here's the practical version with real code examples in curl, Python, PHP, and Node.js. API Basics Endpoint URLs Both AP