Website logo

Send an email to the seller

Sends a message to the seller of a classified via email. If possible, the listing will be added to the authenticated member's watchlist.

URL: https://api.trademe.co.nz/v1/listings/{listingId}/emailSeller.{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

listingId Integer (required)

The ID of the listing the question is about.

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

POST Data

<EmailRequest>

Message String (required) Message
CopyToSelf Boolean (optional) CopyToSelf
PhoneNumber String (optional) PhoneNumber
EmailAddress String (optional) EmailAddress
FirstName String (optional) FirstName
LastName String (optional) LastName
EnquiryType Enumeration (optional) EnquiryType
Unknown 0 Unknown
General 1 General
Finance 2 Finance
TradeIn 3 TradeIn
TestDrive 4 TestDrive
SpecialOffer 5 SpecialOffer
InTransit 6 InTransit
Warranty 7 Warranty
Insurance 8 Insurance
AvailableToOrder 9 AvailableToOrder
CertifiedPreOwned 10 CertifiedPreOwned
ReferringSearchId String (optional) ReferringSearchId

Returns

<EmailResponse>

Success Boolean Success
Description String or null Description

Example XML Request (switch to JSON)

<EmailRequest xmlns="http://api.trademe.co.nz/v1">
  <Message>ABC</Message>
  <CopyToSelf>false</CopyToSelf>
  <PhoneNumber>ABC</PhoneNumber>
  <EmailAddress>ABC</EmailAddress>
  <FirstName>ABC</FirstName>
  <LastName>ABC</LastName>
  <EnquiryType>Unknown</EnquiryType>
  <ReferringSearchId>ABC</ReferringSearchId>
</EmailRequest>

Example JSON Request (switch to XML)

{
  "Message": "ABC",
  "CopyToSelf": false,
  "PhoneNumber": "ABC",
  "EmailAddress": "ABC",
  "FirstName": "ABC",
  "LastName": "ABC",
  "EnquiryType": 0,
  "ReferringSearchId": "ABC"
}

Example XML Response (switch to JSON)

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

Example JSON Response (switch to XML)

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