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 multiple 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 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> (Occurrences: 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> (Occurrences: 1)
|R||#FOLDER ID#||The identifier of the folder that has been created|
|O||The element is optional and does not have to be specified in the request and/or answer|
|R||The element is mandatory and has to specified in the request and/or answer|