Blog Comments

Read, moderate, delete, bulk manage, and subscribe to blog comments through the Store API.

Use these endpoints to read, moderate, and delete blog comments. Reads require read_blog; moderation and deletion require write_blog. Responses include the author's email for moderation. Do not expose management responses as public comment data.

Comments have no replies. Shopper submissions use the hosted comment form and follow the store's comment and moderation settings. A repeated submission with the same receipt does not create a second comment. Spam and trash, and the commenter's personal data, expire. The store's settings response includes the retention notice.

Bulk moderation and deletion apply atomically to the requested existing comments. A moderation call that does not change status does not emit another webhook. Webhook events describe each changed or deleted comment. Deleting a blog post also deletes its comments and emits their deletion events.

Endpoints#

Blog Comment limits

GET read_blog

Fetch blog comment limits.

Returns pagination, search, bulk-operation, field, and moderation-status limits.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

curl 'https://api-store.tringify.com/api/2025-01/blog/comments/limits' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/limits", {
  method: "GET",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/blog/comments/limits",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "author_email_max_length": 255,
    "author_name_max_length": 255,
    "bulk_delete_max_items": 500,
    "bulk_update_max_items": 500,
    "content_max_length": 5000,
    "list_max_limit": 100,
    "list_page_size": 20,
    "page_size_options": [
      20,
      50,
      100
    ],
    "search_max_length": 200,
    "statuses": [
      "pending",
      "approved",
      "spam",
      "trash"
    ]
  },
  "success": true
}

List blog comments

GET read_blog

List blog comments for moderation.

Returns store-wide comments in newest-first order. Filter by status or post, or search author name, author email, and content.

Query parameters

Name	Type	Description
`page`	`integer`	Page number. Example: `1`
`limit`	`integer`	Page size, up to `list_max_limit` from the Blog Comment limits. Example: `20`
`search`	`string`	Search author name, author email, or comment content. Example: `launch`
`status`	`string`	Filter by moderation status. Example: `pending`
`post_id`	`uuid`	Filter by Blog Post id. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 VALIDATION_LIST_INVALID_PAGE
Page must be a positive integer.
400 VALIDATION_LIST_INVALID_LIMIT
Limit must be a positive integer.
400 STORE_API_INVALID_REQUEST_BODY
post_id is not a valid UUID.
400 BLOG_COMMENT_SEARCH_TOO_LONG
Search exceeds the contract maximum.
400 BLOG_COMMENT_STATUS_INVALID
Status is not supported.

curl 'https://api-store.tringify.com/api/2025-01/blog/comments?limit=20&page=1&post_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&search=launch&status=pending' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments?limit=20&page=1&post_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&search=launch&status=pending", {
  method: "GET",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/blog/comments?limit=20&page=1&post_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&search=launch&status=pending",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "comments": [
      {
        "author_email": "avery@example.com",
        "author_name": "Avery Stone",
        "content": "Great update.",
        "created_at": "2026-08-31T12:00:00Z",
        "customer_id": null,
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "post_id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "post_title": "Launch notes",
        "status": "pending"
      }
    ],
    "limit": 20,
    "page": 1,
    "total": 1
  },
  "success": true
}

Get blog comment counts

GET read_blog

Fetch counts by moderation status.

Returns the current pending, approved, spam, and trash counts for the store.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

curl 'https://api-store.tringify.com/api/2025-01/blog/comments/counts' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/counts", {
  method: "GET",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/blog/comments/counts",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "approved": 8,
    "pending": 1,
    "spam": 0,
    "trash": 0
  },
  "success": true
}

Get a blog comment

GET read_blog

Fetch one blog comment.

Returns the comment only when it belongs to the token's store.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Comment id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 STORE_API_INVALID_REQUEST_BODY
Comment id is not a valid UUID.
404 NOT_FOUND
Comment does not exist in this store.

curl 'https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31", {
  method: "GET",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "author_email": "avery@example.com",
    "author_name": "Avery Stone",
    "content": "Great update.",
    "created_at": "2026-08-31T12:00:00Z",
    "customer_id": null,
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "post_id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
    "post_title": "Launch notes",
    "status": "pending"
  },
  "success": true
}

Moderate a blog comment

PUT write_blog

Change one comment's moderation status.

Sets status to pending, approved, spam, or trash. The change, audit record, and update webhook commit atomically.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Comment id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`status` required	`string`	New moderation status. Example: `approved`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Comment id is not a valid UUID.
404 NOT_FOUND
Comment does not exist in this store.
400 STORE_API_INVALID_REQUEST_BODY
Request body is malformed or contains an unknown field.
400 BLOG_COMMENT_STATUS_INVALID
Status is not pending, approved, spam, or trash.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "approved"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31", {
  method: "PUT",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "status": "approved"
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "status": "approved",
    },
)
data = res.json()

Response

200

Sample response

{
  "code": "BLOG_COMMENT_UPDATED",
  "data": {
    "count": 1,
    "ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  },
  "message": "Comment updated.",
  "success": true
}

Bulk moderate blog comments

POST write_blog

Change the moderation status of multiple comments.

Updates every selected comment atomically. If an id is invalid, missing, or belongs to another store, none are changed.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`comment_ids` required	`array<uuid>`	Comment ids to update. Example: `["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"]`
`status` required	`string`	New moderation status. Example: `approved`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is malformed, contains an unknown field, or contains a malformed id.
400 BLOG_COMMENT_BULK_NO_IDS
No comment ids were provided.
400 BLOG_COMMENT_BULK_UPDATE_TOO_MANY
Batch exceeds the bulk update cap.
400 BLOG_COMMENT_STATUS_INVALID
Status is not pending, approved, spam, or trash.
404 NOT_FOUND
One or more comments do not exist in this store.

curl -X POST 'https://api-store.tringify.com/api/2025-01/blog/comments/bulk-update-status' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "comment_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ],
  "status": "approved"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/bulk-update-status", {
  method: "POST",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "comment_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ],
    "status": "approved"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/comments/bulk-update-status",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "comment_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
        "status": "approved",
    },
)
data = res.json()

Response

200

Sample response

{
  "code": "BLOG_COMMENTS_UPDATED",
  "data": {
    "count": 1,
    "ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  },
  "message": "1 comments updated.",
  "success": true
}

Delete a blog comment

DELETE write_blog

Permanently delete one comment.

Deletes the comment atomically with its audit record and delete webhook. This operation cannot be undone.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Comment id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 STORE_API_INVALID_REQUEST_BODY
Comment id is not a valid UUID.
404 NOT_FOUND
Comment does not exist in this store.

curl -X DELETE 'https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31", {
  method: "DELETE",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.delete(
    "https://api-store.tringify.com/api/2025-01/blog/comments/5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "code": "BLOG_COMMENT_DELETED",
  "data": {
    "count": 1,
    "ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  },
  "message": "Comment deleted.",
  "success": true
}

Bulk delete blog comments

POST write_blog

Permanently delete multiple comments.

Deletes every selected comment atomically. If an id is invalid, missing, or belongs to another store, none are deleted.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`comment_ids` required	`array<uuid>`	Comment ids to delete. Example: `["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is malformed, contains an unknown field, or contains a malformed id.
400 BLOG_COMMENT_BULK_NO_IDS
No comment ids were provided.
400 BLOG_COMMENT_BULK_DELETE_TOO_MANY
Batch exceeds the bulk delete cap.
404 NOT_FOUND
One or more comments do not exist in this store.

curl -X POST 'https://api-store.tringify.com/api/2025-01/blog/comments/bulk-delete' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "comment_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/comments/bulk-delete", {
  method: "POST",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "comment_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/comments/bulk-delete",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "comment_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
    },
)
data = res.json()

Response

200

Sample response

{
  "code": "BLOG_COMMENTS_DELETED",
  "data": {
    "count": 1,
    "ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  },
  "message": "1 comments deleted.",
  "success": true
}

Fields#

Field	Type	Create	Update	Required	Translatable
`author_name`	string	No	No		No
`author_email`	string	No	No		No
`content`	string	No	No		No
`post_id`	string (UUID)	No	No		No
`post_title`	string	No	No		No
`customer_id`	string (UUID)	No	No		No
`status`	string	No	Yes	update	No
`created_at`	string (RFC 3339)	No	No		No

Webhook events#

Subscribe to these events to keep your integration in sync with blog comments. Each event shows the required Store API scope and store permission, the available payload fields, and an example payload. Subscription setup is validated against those permissions; delivery is always restricted to the subscription's store.

Blog comment received

EVENT blog_comments/create App scope: read_blog Staff permission: blog:write

Fired when a shopper submits a blog comment (pending or approved per the store's moderation setting).

Payload fields

Field	Type	Description
`blog_comment.id`	`string`	Always present
`blog_comment.post_id`	`string`	Always present
`blog_comment.post_title`	`string`	Selectable in the Payload builder
`blog_comment.post_slug`	`string`	Selectable in the Payload builder
`blog_comment.customer_id`	`string`	Selectable in the Payload builder
`blog_comment.author_name`	`string`	Always present
`blog_comment.content`	`string`	Always present
`blog_comment.status`	`string`	Always present
`blog_comment.created_at`	`string`	Always present

Payload shape

Sample payload

{
  "blog_comment": {
    "author_name": "Avery Stone",
    "content": "Great update.",
    "created_at": "2026-09-01T12:00:00+05:30",
    "customer_id": null,
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "post_id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
    "post_slug": "launch-notes",
    "post_title": "Launch notes",
    "status": "pending"
  }
}

Blog comment updated

EVENT blog_comments/update App scope: read_blog Staff permission: blog:write

Fired when a merchant changes a blog comment's moderation status.

Payload fields

Field	Type	Description
`blog_comment.id`	`string`	Always present
`blog_comment.post_id`	`string`	Always present
`blog_comment.post_title`	`string`	Selectable in the Payload builder
`blog_comment.post_slug`	`string`	Selectable in the Payload builder
`blog_comment.customer_id`	`string`	Selectable in the Payload builder
`blog_comment.author_name`	`string`	Always present
`blog_comment.content`	`string`	Always present
`blog_comment.status`	`string`	Always present
`blog_comment.created_at`	`string`	Always present

Payload shape

Sample payload

{
  "blog_comment": {
    "author_name": "Avery Stone",
    "content": "Great update.",
    "created_at": "2026-09-01T12:00:00+05:30",
    "customer_id": null,
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "post_id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
    "post_slug": "launch-notes",
    "post_title": "Launch notes",
    "status": "pending"
  }
}

Blog comment deleted

EVENT blog_comments/delete App scope: read_blog Staff permission: blog:write

Fired when a merchant permanently deletes a blog comment, including when deleting one or more parent posts cascades their comments.

Payload fields

Field	Type	Description
`blog_comment.id`	`string`	Always present
`blog_comment.post_id`	`string`	Always present
`blog_comment.post_title`	`string`	Selectable in the Payload builder
`blog_comment.post_slug`	`string`	Selectable in the Payload builder
`blog_comment.customer_id`	`string`	Selectable in the Payload builder
`blog_comment.author_name`	`string`	Always present
`blog_comment.content`	`string`	Always present
`blog_comment.status`	`string`	Always present
`blog_comment.created_at`	`string`	Always present

Payload shape

Sample payload

{
  "blog_comment": {
    "author_name": "Avery Stone",
    "content": "Great update.",
    "created_at": "2026-09-01T12:00:00+05:30",
    "customer_id": null,
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "post_id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
    "post_slug": "launch-notes",
    "post_title": "Launch notes",
    "status": "pending"
  }
}