Website logo

Update member selling preferences

Updates the selling preferences of the authenticated member

URL: https://api.trademe.co.nz/v1/Selling/Preferences.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

POST Data

<SellingPreferencesRequest>

OnlyAuthenticatedMembersCanBid Boolean (optional)

Determines if only authenticated members can bid on the listings. Only applicable to auctions, ignored for classifieds.

DonationRecipient Integer (optional)

Indicates the user would like to round up their success fees to the nearest dollar and donate the difference to the selected charity.

ShowPickUpLocation Boolean (optional)

Determines if the listings with pick-up option will be available for Sell Local. When true, the three-tier region/district/suburb location will be displayed for listings with pick-up option. Only applicable to auctions, ignored for classifieds.

PickUpSuburbId Integer (optional)

The pick-up suburb id. It uses the three-tier region/district/suburb system. Required when Sell Local is enabled (ShowPickUpLocation is true). Only applicable to auctions, ignored for classifieds.

Returns

<SellingPreferencesResponse>

Indicates whether or not the operation succeeded.

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

Example XML Request (switch to JSON)

<SellingPreferencesRequest xmlns="http://api.trademe.co.nz/v1">
  <OnlyAuthenticatedMembersCanBid>false</OnlyAuthenticatedMembersCanBid>
  <DonationRecipient>123</DonationRecipient>
  <ShowPickUpLocation>false</ShowPickUpLocation>
  <PickUpSuburbId>123</PickUpSuburbId>
</SellingPreferencesRequest>

Example JSON Request (switch to XML)

{
  "OnlyAuthenticatedMembersCanBid": false,
  "DonationRecipient": 123,
  "ShowPickUpLocation": false,
  "PickUpSuburbId": 123
}

Example XML Response (switch to JSON)

<SellingPreferencesResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
</SellingPreferencesResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC"
}