Create a tag (Called a "list" within the GUI application).


XML Request Example:    

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



XML

 <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeName of API set to be used
requestmethodFunction being called


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.


<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 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