Upload Return Attachment

POST

/partner/v1/returns/attachments

Uploads one evidence file (image or mp4) for a return. The file stays pending until POST /returns names its id in attachment_ids (max 10 per return).

Send as multipart/form-data with a single file field. Allowed types and size limits follow the customer return attachment policy.

Scope: refunds:write.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params multipart/form-dataRequired

Responses

🟢201Created

application/json

Bodyapplication/json

🟠400Validation failed

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location '/partner/v1/returns/attachments' \
--header 'X-Store-Id: {{partner_store_id}}' \
--header 'Accept-Language: en' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

201 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "url": "string",
        "media_type": "string",
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}

Create Return Reason

Create Return