Create one or more tags (Called "lists" within the GUI application).


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>JohnDoe</username>
  <usertoken>abc123abc123abc123abc123</usertoken>
  <requesttype>Tags</requesttype>
  <requestmethod>CreateTags</requestmethod>
  <details>
    <tag> <!-- required -->
      <name>{*name*}</name> <!-- required -->
      <description>{*description*}</description>
    </tag>
    <tag>
      <name>{*name*}</name>
      <description>{*description*}</description>
    </tag>
  </details>
</xmlrequest>


XML

 <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeTags
requestmethodCreateTags


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, If no description is to be added, remove the <description>{*description*}</description> element. In addition, if only one tag being created, remove all unused <tag></tag> elements including their content.


<details> element

<tag>


Field NameDescription
name
(Required)
Name of tag to be created.  
description
Optional description of tag being created.


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if tag was successfully created
dataTag count created, tag Id, username of creator, description and create / update date.


Unsuccessful Response:


<response> element


Field NameDescription
statusWill return FAILED if unsuccessful
errormessageText explaining why request failed