Creating Reseller Accounts

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.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

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:

ResellerAddInput

Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.

 

Response Packet Structure

The add node of the response packet is structured as follows:

ResellerAddOutput

 

Operation-specific Errors

1024 - License limits are reached.

 

 

Samples

Creating a reseller account with the minimum of settings:

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>

Creating a reseller account basing on the common plan settings

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>
Creating multiple reseller accounts

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>