Shopify Order API - Update Notes Isn't Working

Topic summary

Problem: updating an order’s note through the Shopify Admin REST API was failing in a Python request, even though GET requests and some other order/product operations were working.

Key fix:

  • The update endpoint requires a PUT request, not POST.
  • The payload shown used the order ID and a new note value, which is supported by Shopify’s order update endpoint.
  • “PUT” means replacing/updating an existing resource, while “POST” is typically used to create one.

Outcome:

  • The original issue was resolved after switching to the correct HTTP method.
  • The poster confirmed the note update worked once they realized this mistake.

Current open question:

  • A later reply asked whether order notes can be appended to instead of fully replaced.
  • No answer or confirmed solution for appending notes appears in the discussion, so that part remains unresolved.

No images, attachments, or extra code beyond the request example were central to the discussion.

Summarized with AI on March 5. AI used: gpt-5.4.

Hi,

I can’t seem to be able to use the Shopify Order API to update notes for orders in my shop. I am using Python and have included a snippet of the code below (excluding Shopify Keys and Order Details).

json = {"order":  {"id": 691745259575,
     "note": "Custom Note From API"}
}
headers = {"Accept": "application/json", "Content-Type": "application/json"}
shopRequestUrl = "https://{ShopifyKey}:{ShopifySecret}@intuitive-audio-limited.myshopify.com/admin/api/2020-01/orders/691745259575.json"
r = requests.post(shopRequestUrl, json = json, headers = headers)
print(r.json())

The GET Requests are working fine, and creating a New Orders/Products using PUT Requests also works, but I can’t seem to be able to update the order notes (based on the Shopify API Guides I was under the impression that this was possible https://help.shopify.com/en/api/reference/orders/order#update-2020-01). I have also tried including the Order Id as an “int” rather than String value, but this doesn’t seem to be working either.

If anyone could provide any assistance it would be greatly appreciated.

Regards,

Mark

Hey @markbarbaric ,

You’ll need to send via PUT method. Here’s an example.

Hi Scotty,

Thanks for getting back to me. I realised my mistake the other day. This is working now.

Thanks again,

Mark

1 Like

Hi All,

Is there any way to append the notes instead of replace.

Thanks