Check whether a token can be used to successfully authorize API requests.


XML Request Example:     

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
   <username>admin</username>
   <usertoken>abc123abc123abc123abc123abc123abc123abc123abc123</usertoken>
   <requesttype>authentication</requesttype>
   <requestmethod>xmlapitest</requestmethod>
   <details>
   </details>
</xmlrequest>

  <xmlrequest> element


Field Name Description
username Username used to login to Pinpointe
usertoken Unique token assigned to Pinpointe account
requesttype Name of API set to be used
requestmethod Function being called
details This empty element is required



Successful Response:


<response> element


Field Name Description
status Will return SUCCESS if user was successfully added
data Returns 1 if successfully authorized


Unsuccessful Response:


<response> element


Field Name Description
status Will return SUCCESS if user was successfully added
errormessage Text explaining why request failed