POST v1/clients

Creates a client

Request Information

URI Parameters

None.

Body Parameters

An object representing the client.

Client
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.
Name

string

None.
BaseAddress

string

None.
Uri

string

None.

Request Formats

application/json, text/json

Sample: 
{
  "Id": "cdf73880-9ef9-4ab9-a294-520306448c5d",
  "Name": "sample string 2",
  "BaseAddress": "sample string 3",
  "Uri": "sample string 4"
}

text/html

Sample: 
{"Id":"cdf73880-9ef9-4ab9-a294-520306448c5d","Name":"sample string 2","BaseAddress":"sample string 3","Uri":"sample string 4"}

application/xml, text/xml

Sample: 
<Client xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Models">
  <BaseAddress>sample string 3</BaseAddress>
  <Id>cdf73880-9ef9-4ab9-a294-520306448c5d</Id>
  <Name>sample string 2</Name>
  <Uri>sample string 4</Uri>
</Client>

Response Information

Resource Description

A response containing the new Client's unique id, or validation errors if the client could not be created.

ClientPostResponse
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.

Response Codes

  • 201 Created: Client successfully created.
  • 400 BadRequest: Data validation failed, see the response body for more information.
  • 401 Unauthorized:
  • 500 InternalServerError:

Response Formats

application/json, text/json

Sample: 
{
  "Id": "3c075dde-dde2-481e-b2bc-738c6c981cf3"
}

text/html

Sample: 
{"Id":"3c075dde-dde2-481e-b2bc-738c6c981cf3"}

application/xml, text/xml

Sample: 
<ClientPostResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Responses">
  <Id>3c075dde-dde2-481e-b2bc-738c6c981cf3</Id>
</ClientPostResponse>