POST/respond_to_feedback
This method allows users to respond to feedback provided by the order partner for a specific line item in an order. For each order, the order partner is the other participant in the transaction, either the buyer or seller, depending on the eBay user associated with the user token. This method allows the user to provide additional context or address the order partner's feedback.
Note: The feedback response must adhere to community guidelines and be relevant to the transaction.
You can only use this method if feedback has been provided by the order partner and you have not yet responded to it.
When responding to feedback, your feedback score is not affected when you respond to feedback.
For additional information on leaving feedback, see the following:
A successful call returns an HTTP status of 200 Success.
Input
Resource URI
This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com
root URI with api.sandbox.ebay.com
URI parameters
This method has no URI parameters.
HTTP request headers
All requests made to eBay REST operations require you to provide the Authorization
HTTP header for authentication authorization.
The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.
Header | Type | Description |
---|---|---|
Content-Type | string | This header indicates the format of the request body provided by the client. Its value should be set to application/json. For more information, refer to HTTP request headers. Occurrence: Required |
OAuth scope
This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
https://api.ebay.com/oauth/api_scope/commerce.feedback
See OAuth access tokens for more information.
Request payload
Copy complete valid JSON to clipboardRequest fields
Input container/field | Type | Description |
---|---|---|
feedbackId | string | Use this field to provide the unique identifier for the feedback being responded to, used to specify the feedback entry associated with the feedback response. This value can be returned using the getFeedback method (feedbackId field). Occurrence: Required |
recipientUserId | string | Use this field to provide the identifier of the user who provided the original feedback. This value can be returned using the getFeedback method (userId field). Occurrence: Required |
responseText | string | Use this field to provide the text content of the response. This field is used to provide additional context or address the feedback given by the order partner. No HTML formatting or personal information (such as phone numbers) is permitted. Occurrence: Required |
responseType | ResponseTypeEnum | Set this enumerated value to describe the type of response being submitted (for example, a Occurrence: Required |
Output
HTTP response headers
This call has no response headers.
Response payload
This call has no payload.
Response fields
This call has no field definitions.
HTTP status codes
This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.
Status | Meaning |
---|---|
200 | Success |
400 | Bad Request |
401 | Not Authorized |
403 | Forbidden |
409 | Conflict |
500 | Internal Server Error |
Error codes
For more on errors, plus the codes of other common errors, see Handling errors.
Code | Domain | Category | Meaning |
---|---|---|---|
501011 | API_FEEDBACK | BUSINESS | Feedback provider is not eligible to leave feedback. |
501013 | API_FEEDBACK | REQUEST | Comment text is too long, maximum length is 500 characters. |
501014 | API_FEEDBACK | REQUEST | Comment text value is invalid. |
501015 | API_FEEDBACK | REQUEST | Comment text contains profanity. |
501026 | API_FEEDBACK | REQUEST | Feedback ID request parameter is required or is invalid. |
501027 | API_FEEDBACK | REQUEST | Response type request parameter is required or is invalid. Must be REPLY or FOLLOW_UP. |
501028 | API_FEEDBACK | REQUEST | Response text request parameter is required. |
501029 | API_FEEDBACK | REQUEST | Recipient user ID request parameter is required. |
501030 | API_FEEDBACK | BUSINESS | Feedback ID for respond to feedback not found. |
501031 | API_FEEDBACK | BUSINESS | Reply not allowed for automated feedback. |
501032 | API_FEEDBACK | BUSINESS | Reply already left for feedback. |
501033 | API_FEEDBACK | BUSINESS | Follow up comment already left for feedback. |
Warnings
This call has no warnings.
Samples
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
Sample 1: Reply to feedback
This call responds to the user's order partner feedback for a line item in the order.
Input
The inputs are the feedback ID, the recipient user ID, the response text, and the type of response.
POSThttps://api.ebay.com/commerce/feedback/v1/respond_to_feedback
Output
If the call is successful, HTTP status code 200 Success is returned.