Create Ticket My Tickets Post Discussion
Welcome
Login  Sign up

POST User

TABLE OF CONTENTS

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.

Parameter Name
Data Type
Required
Description
User
User
Yes
The User that you wish to create.  See the User type definition from the GET above.

POST Response

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

User Response (<UserResponse>)

Field Name
Data Type
Description
User
User
The User created
ResponseStatus
ResponseStatus
Details of any errors that may have occurred

User (<User>) Response Fields

The User returned is only populated with the following fields:

Field Name
Data Type
Description
Id
GUID
Unique identifier of the new User
Status
String
Status of this User which will be set to Invited



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>


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.