Feature Request: Add API access to private order notes

[djdalio]

Hi Etsy Open API team,

I would like to request API access to the private seller note attached to an order in Etsy Shop Manager.

I am referring specifically to the "Private note" field shown on an order, which is marked with:

"Only you can see this note"

Currently, order information can be retrieved through the Open API, but this private internal note does not appear to be exposed through the ShopReceipt resource or another API endpoint.

Use case

We use an external order management system and synchronize Etsy orders using the Etsy Open API.

We also maintain internal notes for orders, for example:

• production instructions
• customization details
• internal reminders
• fulfillment information
• information that should not be visible to the buyer

Being able to retrieve Etsy's existing private order note would prevent having to maintain the same information separately in Etsy and in external order management systems.

Suggested implementation

It would be very useful to expose this note through the API, for example as a field on ShopReceipt:

private_note

Read access would already be very helpful.

Ideally, the API could eventually support both:

• Reading the private order note
• Creating/updating the private order note

This could use the existing order/transaction permissions or a dedicated OAuth scope if necessary.

To clarify, I am not referring to message_from_buyer or message_from_seller, but specifically to the internal seller-only Private Note available in Etsy Shop Manager.

Thank you for considering this feature!