The WebFaction API is an XML-RPC interface for managing many control panel and account tasks. With the WebFaction API, you can automate application installation, email address configuration, and more.

Like other XML-RPC APIs, the WebFaction API works by sending a short piece of XML over HTTP. Luckily, many languages have XML-RPC libraries to help you make such requests.

For example, you can send an XML-RPC request using Python‘s xmlrpclib module:

>>> import xmlrpclib
>>> server = xmlrpclib.ServerProxy('')
>>> session_id, account = server.login('widgetsco', 'widgetsrock', 'Web500', 2)

Or with Ruby’s xmlrpc package:

>> require 'xmlrpc/client'
=> true
>> require 'pp'
=> true
>> server = XMLRPC::Client.new2("")
#<XMLRPC::Client:0x5b1698 @cookie=nil, @create=nil, @port=443>
>> pp"login", "widgetsco", "widgetsrock", "Web55", 2)
=> nil

To learn more about XML-RPC and find an implementation in your favorite language, please visit

For a more in-depth tour of the API, see Tutorial. For a complete reference of calls, parameters, and return values, see API Reference.

Table Of Contents

Search the documentation

Example: "configure email"
or "create database"