Call Us Today! 877.742.2583

Page tree
Skip to end of metadata
Go to start of metadata


mod_xml_rpc allows you to use the webapi - firing any API from the web browser just as you would from the FS console!

API command documentation can be found in the mod_commands section.


To use, you must enable this module within the conf/autoload_configs/modules.conf.xml file and restart the switch. You can configure the module (HTTP port, domain, login/password) within the conf/autoload_configs/xml_rpc.conf.xml file.

The basic syntax would be:

http://<freeswitch-hostname-or-IP>:8080/webapi/<api command>

For example:


  • HTTP only, no HTTPS
  • port 8080
  • Typical HTTP authentication - username, password (default is freeswitch/works)

Generally, the web root is {prefix}/freeswitch/htdocs.

Other HTML/JavaScript/etc. files in htdocs will get served up as requested.

When using an API command that has more than one word, use a question mark to separate the first and second words, then a space for the rest.


Returning data to the webpage using Lua and stream:write

To execute a FS command from a web page and display the result in the webpage use:

See also

1 Comment

  1.  In page FreeSWITCH XML-RPC  I can find the freeswitch.api  examples,

    but where can I find the some examples ?