Questions
Overview
What a question is and the rules that apply to all its endpoints.
A question is the public doubt a buyer asks on a listing, before the purchase. The seller answers, and the answer shows on the listing. It belongs to a Connection and, when the listing was imported, to a Listing (listingId).
How customer service works end to end: Serve buyers.
Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/questions | List questions |
GET | /v1/questions/{questionId} | Get question |
POST | /v1/questions/{questionId}/answers | Answer question |
POST | /v1/questions/{questionId}/actions | Run an action |
All require Authorization: Bearer mk_your_api_key. See Authentication.
States
status | Meaning |
|---|---|
unanswered | waiting for an answer |
answered | the answer was published |
under_review | the marketplace is moderating it |
deleted | the question was deleted |
The answer has its own state: sending, published, under_review, rejected or failed.
Rules
- Only an
unansweredquestion can be answered. Before that, the response is409question_not_answerable. - Answering and acting are jobs: the API returns
202and you follow theid. - The author appears only as an external id, with no name.
- Limits (such as the answer length) vary by marketplace. See Capabilities.
Webhook
question.received arrives when a new question comes in. It carries ids only (questionId, listingId, status…), never the text. Read the text with Get question. See Receiving webhooks.