Using createUploadDestinationForResource SP API Uploads API call in process of uploading listings images

[ShamilS]

I'm using createUploadDestinationForResource SP API Uploads API call to get an upload destination for a listing image to be uploaded. It works, but when I'm using returned upload URL to upload an image I'm getting an error message: "Conflicting query string parameters: acl, policy".

FYI: the destination URL returned by createUploadDestinationForResource SP API Uploads API call has the following format:

https://aplus-media.s3.amazonaws.com/
?x-amz-date=20250928T224752Z
&x-amz-signature={x-amz-signature}
&x-amz-meta-owner={meta-owner}
&acl=private
&key=sc/94cb2445-81fb-4c76-9904-ef258bbc37bc.jpg
&x-amz-algorithm=AWS4-HMAC-SHA256
&policy={policy}
&x-amz-credential={access-key}/20250928/us-east-1/s3/aws4_request

where {policy} is happening to be a base64 encoded JSON:

{"conditions":
   [{"bucket":"aplus-media"},
    {"key":"sc/94cb2445-81fb-4c76-9904-ef258bbc37bc.jpg"},
    {"acl":"private"},
    {"x-amz-meta-owner":"{meta-owner}"},
    {"x-amz-algorithm":"AWS4-HMAC-SHA256"},
    {"x-amz-credential":"{access-key}/20250928/us-east-1/s3/aws4_request"},
    {"x-amz-date":"20250928T224752Z"},
    ["content-length-range",1,3145728
   ]
   ],
 "expiration":"2025-09-29T01:47:52.285Z"}

with values of {meta-owner} and {access-key} being the same as the destination upload url's parameters.

What could be causing "Conflicting query string parameters: acl, policy" error message in the above context?

[BrunnoPigatto]

Hello @ShamilS,

For the A+ resource, the query parameters in the url returned in the operation createUploadDestinationForResource needs to be passed to the body as form-data, along with the binary content of the image that you want to submit.

Example 👇

Step1. create Upload Destination For Resource

Request

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/uploads/2020-11-01/uploadDestinations/aplus/2020-11-01/contentDocuments?marketplaceIds=A2Q3Y263D00KWC&contentMD5=96vO9ELWZIzw7hkqXSerZw%3D%3D&contentType=image%2Fjpeg' \
--header 'Accept: application/json' \
--header 'x-amz-access-token: Atza|IwE...'

Response

{
    "errors": [],
    "payload": {
        "uploadDestinationId": "aplus-media/sc/f3af8f70-ec5d-47fb-a118-c4d36654bd8c.jpg",
        "url": "https://aplus-media.s3.amazonaws.com/?x-amz-date=20251003T113949Z&x-amz-signature={{signature}}&x-amz-meta-owner=A2ZPJ4TLUOSWY8&acl=private&key=sc/f3af8f70-ec5d-47fb-a118-c4d36654bd8c.jpg&x-amz-algorithm=AWS4-HMAC-SHA256&policy=eyJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJhcGx1cy1tZWRpYSJ9LHsia2V5Ijoic2MvZjNhZjhmNzAtZWM1ZC00N2ZiLWExMTgtYzRkMzY2NTRiZDhjLmpwZyJ9LHsiYWNsIjoicHJpdmF0ZSJ9LHsieC1hbXotbWV0YS1vd25lciI6IkEyWlBKNFRMVU9TV1k4In0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1jcmVkZW50aWFsIjoiQUtJQTRSUzVaVlZMNlBUT1pSNVMvMjAyNTEwMDMvdXMtZWFzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LHsieC1hbXotZGF0ZSI6IjIwMjUxMDAzVDExMzk0OVoifSxbImNvbnRlbnQtbGVuZ3RoLXJhbmdlIiwxLDMxNDU3MjhdXSwiZXhwaXJhdGlvbiI6IjIwMjUtMTAtMDNUMTQ6Mzk6NDkuMjg0WiJ9&x-amz-credential={{access-key}}/20251003/us-east-1/s3/aws4_request",
        "headers": null
    }
}

Step2. Upload image

Request

curl --location 'https://aplus-media.s3.amazonaws.com/' \
--form 'x-amz-date="20251003T113949Z"' \
--form 'x-amz-signature="{{signature}}"' \
--form 'x-amz-meta-owner="A2ZPJ4TLUOSWY8"' \
--form 'acl="private"' \
--form 'key="sc/f3af8f70-ec5d-47fb-a118-c4d36654bd8c.jpg"' \
--form 'x-amz-algorithm="AWS4-HMAC-SHA256"' \
--form 'policy="eyJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJhcGx1cy1tZWRpYSJ9LHsia2V5Ijoic2MvZjNhZjhmNzAtZWM1ZC00N2ZiLWExMTgtYzRkMzY2NTRiZDhjLmpwZyJ9LHsiYWNsIjoicHJpdmF0ZSJ9LHsieC1hbXotbWV0YS1vd25lciI6IkEyWlBKNFRMVU9TV1k4In0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1jcmVkZW50aWFsIjoiQUtJQTRSUzVaVlZMNlBUT1pSNVMvMjAyNTEwMDMvdXMtZWFzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LHsieC1hbXotZGF0ZSI6IjIwMjUxMDAzVDExMzk0OVoifSxbImNvbnRlbnQtbGVuZ3RoLXJhbmdlIiwxLDMxNDU3MjhdXSwiZXhwaXJhdGlvbiI6IjIwMjUtMTAtMDNUMTQ6Mzk6NDkuMjg0WiJ9"' \
--form 'x-amz-credential="{{access-key}}/20251003/us-east-1/s3/aws4_request"' \
--form 'File=@"/Users/brunnomi/Downloads/E015GUGD2V6-U047AFVTK40-139769f30336-512.png"'

Response

Status 204 🟢

The response should return empty

Kindly review the steps 3b and 3c of the guide on Create, edit, and publish A+ content.

Thanks,
Brunno M.
Selling Partner API Developer Services

[ShamilS]

Hello Bruno,

Thank you, I have also already found that the form-data has to be used to upload an image to the upload destination, and I have developed a Python script to do that (I can post it here is appropriate).

But I'm still missing how to upload an image to the [Offer] section of an Amazon Seller Central account Inventory item (SKU) - there could be max 6 images uploaded there, as opposed to the [Images] section of such Inventory item section, where there could be 9 images uploaded. I know how to do the latter using SP API.
It's a bit off-topic or an image uploaded to the upload destination can be somehow further "promoted" using SP API(?) to have it uploaded to the [Offer] section, and therefore visible on Amazon Marketplace together with a proposal item other information?

[BrunnoPigatto]

Hello @ShamilS,

Thank you for clarifying the topic. Regarding using images uploaded in Uploads API, at a product/offer level, currently is not possible to do so. Files uploaded through Uploads API can only be used for A+ Content API and Messaging API. To submit images to products through Listing Items API, you need to first host the image in one of the following sources:

• Publicly accessible Amazon S3 bucket content downloaded through HTTP or HTTPS URL
• Publicly accessible Amazon CloudFront distribution content downloaded through HTTP or HTTPS URL
• Private Amazon S3 bucket content downloaded through S3 URL (for example, s3://bucket-name/object-name.jpg)
• Images hosted on third-party servers that are publicly available to Amazon.

For more information, kindly revert to the following documentation pages:

1. Submitting images and other media attributes
2. Submit images for listings items

Thanks,
Brunno M.
Selling Partner API Developer Services