ebay_upload_post_order_document
Upload PDF, JPEG, BMP, GIF, or PNG documents (up to 5 MiB) for a post-order entity like a return, returning a documentId for subsequent eBay GraphQL publishing.
Instructions
Upload a PDF, JPEG/JPG, BMP, GIF or PNG (up to 5 MiB) for a post-order entity. Returns documentId and Location; initial state is SUBMITTED. Publishing requires a separate eBay GraphQL mutation. Animated/multi-page PNG is unsupported; PDF page limits depend on usage. Requires commerce.post_order.document consent and keyset eligibility. Local file access is opt-in: the file must sit inside a directory listed in EBAY_MCP_MEDIA_DIRS (or under EBAY_MCP_MEDIA_ROOT, which also anchors media:// references). Symlinks are resolved before the check.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"documentUsageType": "<documentUsageType>",
"entityType": "<entityType>",
"entityId": "<entityId>",
"path": "<path>"
},
"name": "ebay_upload_post_order_document"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path or media:// reference inside the media allowlist | |
| entityId | Yes | Identifier of the post-order entity | |
| entityType | Yes | Post-order entity type, e.g. RETURNS | |
| documentUsageType | Yes | Document usage, e.g. RETURN_SHIPPING_LABEL |