POST User

POST Request

You may use either JSON or XML formats in your request. 
You indicate this by setting the ContentType HTTP header as “application/json” or “application/xml”. If no ContentType is specified, XML format is assumed.

The required and optional parameters for a POST to the Users API are outlined below.

POST Response

The data returned from a User POST is provided as follows:

User Response (<UserResponse>)

User (<User>) Response Fields
The User returned is only populated with the following fields:

API Usage Example

Given that the API is REST based, you can access the API directly via your web browser to test it.  Obviously for actual integration works, you will need to make a web request to the given REST URL and then parse the response.

Below is a simple POST example which creates a User, using XML format.  

<User>
  <CompanyId>0</CompanyId>
  <Email>String</Email>
  <ExternalId>String</ExternalId>
  <FirstName>String</FirstName>
  <Folders>
  <Id>00000000-0000-0000-0000-000000000000</Id>
  </Folders>
  <Groups>
  <Id>00000000-0000-0000-0000-000000000000</Id>
  </Groups>
  <Id>00000000-0000-0000-0000-000000000000</Id>
  <IntegrationKey>String</IntegrationKey>
  <LastName>String</LastName>
  <Password>String</Password>
  <Status>String</Status>
  <WebsiteRole>String</WebsiteRole>
 </User>

XML Response  

<UserResponse>
  <User>
  <Id>00000000-0000-0000-0000-000000000000</Id>
  <Status>String</Status>
  </User>
  <ResponseStatus>
  <ErrorCode>String</ErrorCode>
  <Message>String</Message>
  <Errors>
  <ResponseError>
  <ErrorCode>String</ErrorCode>
  <FieldName>String</FieldName>
  <Message>String</Message>
  </ResponseError>
  </Errors>
  </ResponseStatus>
 </UserResponse>