folder:add

Add a new folder to categorize and organize your domains

Domain folders are virtual folders associated with your domain names that help you categorize and organize your domains. Using folders, you can stay organized and make certain changes to many domains at once.

You can create a new folder by using the API request below. Please note that a folder may not contain mutiple subfolders with the same name. By specifing the identifier of the parent folder (folder:parentid) you can create the new folder as a subfolder of the parent folder. If you do not specify the identifier of the parent folder, the new folder will be created on the root level.

During the registration of a new domain, you can automatically put this domain in a specific folder by adding the tag domain:folderid to your domain:create request.

XML Template
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:folder="http://www.eurodns.com/folder">
    <folder:add>
        <folder:name>#FOLDER NAME#</folder:name>
        <folder:parentid>#FOLDER PARENT FOLDER ID#</folder:parentid>
    </folder:add>
</request>

<folder:add> (Occurences: 1)
R #FOLDER NAME# The name of the folder to add
O #FOLDER PARENT FOLDER ID# The identifier of the parent folder
If the action was successful, the following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:folder="http://www.eurodns.com/folder">
    <result code="1000">
        <msg>Command completed successfully</msg>
    </result>
    <resData>
        <folder:id>#FOLDER ID#</folder:id>
    </resData>
</response>

<resData> (Occurences: 1)
R #FOLDER ID# The identifer of the folder that has been created
Legend
O The element is optional an does not have to be specified in the request and/or answer
R The element is mandatory and has to specifed in the request and/or answer