# API for adding Order timeline comments

**URL:** <https://community.shopify.dev/t/api-for-adding-order-timeline-comments/12271>\
**Category:** Products and Orders APIs\
**Tags:** admin-api-orders\
**Created:** [March 27, 2025, 5:31pm UTC](https://community.shopify.dev/t/api-for-adding-order-timeline-comments/12271 "2025-03-27T17:31:07Z")\
**Posts on this page:** 1\
**Showing post:** 4

<div class="post-metadata">

**Author:** ![SimJoSt](https://sea1.discourse-cdn.com/shopifycommunity/user_avatar/community.shopify.dev/simjost/32/2820_2.png) [@SimJoSt](https://community.shopify.dev/u/SimJoSt)\
**Post date:** [November 20, 2025, 1:48pm UTC](https://community.shopify.dev/t/api-for-adding-order-timeline-comments/12271/4 "2025-11-20T13:48:44Z")

</div>

That feature has been a request since September 2019 on the old / non-dev forums:

> **[Request: Add Comments to Order via API](https://community.shopify.com/t/request-add-comments-to-order-via-api/5873)**
>
> It would be really useful to be able to add Order comments (that show up in the Timeline) via the API.

I feel like this is an important feature missing to make sure apps and Flow automations can communicate with the people actually working on orders and to provide some transparency.

And as this is not a question if this is possible, but a feature request, the “solved” status feels disingenuous.

Similar topics:

> [@How can I create a customer timeline comment via Admin API (CommentEvent)?](https://community.shopify.dev/t/how-can-i-create-a-customer-timeline-comment-via-admin-api-commentevent/25735):
>
> Hi! I’m trying to add a comment to a customer’s timeline programmatically. I see the CommentEvent object in the Admin GraphQL API docs, and I can query existing timeline comments, but I can’t find any mutation (like commentEventCreate) to create a new timeline comment. Does Shopify currently allow apps to create timeline comments for customers (or orders) through the Admin API? If so, which mutation should I use? If not, is this feature planned? Thank you!

> [@Create timeline comment for discounts, products, etc](https://community.shopify.dev/t/create-timeline-comment-for-discounts-products-etc/17866):
>
> I’ve noticed that some graphql resources return timeline comments, if you query for connected events, for example this will return up to 10 messages: query DiscountWithComments { discountNodes(first: 5) { edges { node { metafield(key: "key", namespace: "$app:namespace") { id } events(first: 10) { \_\_typename nodes { \_\_typename …

> **[Add a timeline comment using Flow when a particular tag is added](https://community.shopify.com/t/add-a-timeline-comment-using-flow-when-a-particular-tag-is-added/342144)**
>
> I need to be able to tell when I have put an order through to my warehouse, I need a timeline stamp for when I put a ‘Process’ tag on an order. I would like this automated so the Process tag automatically creates either a timeline comment or a...

> [@\[Feature Request\] Allow Flows to add comments to resources](https://community.shopify.dev/t/feature-request-allow-flows-to-add-comments-to-resources/25982):
>
> It would be great if Shopify Flow would allow adding timeline comments to orders (and other resources). With many Flows making changes to orders, it would be great if it could transparently document them for the non-technical staff members working on them. Attaching logs as a file would be sublime, as the Flow logs are purged after 14 days. This feature request has been on the old / non-dev community forum since July 2024 as well: Similar topics are:

---

_[View the full topic](https://community.shopify.dev/t/api-for-adding-order-timeline-comments/12271)._
