The add operation is used to create reseller accounts.
A reseller account presents personal information on a reseller and a collection of various settings. These settings are as follows:
The personal information is always specified when a reseller account is created, while the settings can be specified later. The only exception is a reseller plan. It can be applied only when creating a reseller account. To learn more about reseller plans, refer to the Managing Reseller Plans section.
A request XML packet adding a new reseller to Plesk, includes the add operation node:
<packet>
<reseller>
<add>
...
</add>
</reseller>
</packet>
The add node is presented by the ResellerAddInput complex type (reseller.xsd
). Its graphical representation is as follows:
reseller.xsd
). To view the structure of this node, refer to the Type ResellerAddGenInfo section.reseller.xsd
). To view structure of this node, refer to the Limits section.plesk_client.xsd
). To view structure of this node, refer to the Permissions section.common.xsd
).
Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.
The add node of the response packet is structured as follows:
common.xsd
).common.xsd
). Allowed values: ok|error
.common.xsd
).
Operation-specific Errors
1024 - License limits are reached.
The following packet creates a reseller account with the minimum of settings:
<packet version="1.6.0.2">
<reseller>
<add>
<gen-info>
<pname>John Doe</pname>
<login>JDoe</login>
<passwd>sample</passwd>
</gen-info>
</add>
</reseller>
</packet>
Response:
<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.0.2">
<reseller>
<add>
<result>
<status>ok</status>
<id>3</id>
<guid>f3cb0163-8fc2-4192-9921-98abd25d9cc2</guid>
</result>
</add>
</reseller>
</packet>
The following packet creates a reseller account basing on the common plan settings.
<packet version="1.6.3.0">
<reseller>
<add>
<gen-info>
<cname>LogicSoft Ltd.</cname>
<pname>John Doe</pname>
<login>JDoe</login>
<passwd>Jhtr66fBB</passwd>
<status>0</status>
<phone>416 907 9944</phone>
<fax>928 752 3905</fax>
<email>host@example.com</email>
<address>105 Brisbane Road, Unit 2</address>
<city>Toronto</city>
<country>CA</country>
</gen-info>
<plan-name>common</plan-name>
</add>
</reseller>
</packet>
Response:
<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.0.2">
<reseller>
<add>
<result>
<status>ok</status>
<id>3</id>
<guid>f3cb0163-8fc2-4192-9921-98abd25d9cc2</guid>
</result>
</add>
</reseller>
</packet>
To create multiple reseller accounts, use a separate add operation for each:
<packet version="1.6.3.0">
<reseller>
<add>
<gen-info>
<cname>LogicSoft Ltd.</cname>
<pname>John Doe</pname>
<login>JDoe</login>
<passwd>Jhtr66fBB</passwd>
<status>0</status>
<phone>416 907 9944</phone>
<fax>928 752 3905</fax>
<email>host@example.com</email>
<address>105 Brisbane Road, Unit 2</address>
<city>Toronto</city>
<country>Canada</country>
</gen-info>
</add>
<add>
<gen-info>
<cname>TechnoSoft Ltd.</cname>
<pname>Richard Roe</pname>
<login>RRoe</login>
<passwd>Jk8Dhh6fBB</passwd>
<status>0</status>
<phone>416 907 3366</phone>
<fax>928 752 3377</fax>
<email>james@example.com</email>
<address>122 Greenroad Valley, Unit 1</address>
<city>Toronto</city>
<country>Canada</country>
</gen-info>
<plan-name>base_plan</plan-name>
</add>
</reseller>
</packet>