Skip to main content
POST
/
comments
/
v3
/
comments
Create a new comment
curl --request POST \
  --url https://api.hubapi.com/comments/v3/comments \
  --header 'Content-Type: application/json' \
  --data '
{
  "comment": "This is a test blog comment",
  "contentId": "6513512292",
  "collectionId": "6513512292",
  "contentTitle": "This is a test blog title",
  "userEmail": "tester@gmail.com",
  "userName": "tester",
  "contentAuthorEmail": "author@example.com",
  "contentAuthorName": "Blog Author",
  "contentPermalink": "https://example.com/blog-post"
}
'
{
  "id": 409700798,
  "portalId": 62515,
  "contentId": 6513512292,
  "contentTitle": "This is a test blog title",
  "contentPermalink": null,
  "collectionId": 6513512292,
  "createdAt": 1550599262439,
  "deletedAt": 0,
  "userName": "tester",
  "firstName": "tester",
  "lastName": "",
  "userEmail": "tester@gmail.com",
  "comment": "This is a test blog comment",
  "userUrl": "",
  "state": "PENDING_AKISMET",
  "userIp": "216.107.205.146",
  "userReferrer": "https://tools.hubteam.com/api/post/api.hubapi.com%2Fcomments%2Fv3%2Fcomments%3F",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3626.109 Safari/537.36",
  "contentAuthorEmail": null,
  "contentAuthorName": null,
  "contentCreatedAt": 0,
  "threadId": "0001.0000.0000.0000.0000.0000.0000.0000.0000.0000",
  "replyingTo": null,
  "parentId": 0,
  "legacyId": 0,
  "extraContext": null,
  "parent": null
}

Body

application/json
comment
string
required

The full text of the comment

contentId
integer<int64>
required

The id of the parent blog post

collectionId
integer<int64>
required

The ID of the blog that the post is a part of

contentAuthorEmail
string
required

The email address of the blog post author

contentAuthorName
string
required

The name of the blog post author

URL to the blog post

contentTitle
string
required

Title of the blog post

userEmail
string
required

The email address of the comment author

userName
string
required

The name of the comment author

userUrl
string

The homepage of the comment author

Response

Comment created.

id
integer<int64>

The unique id of the comment

portalId
integer<int64>
contentId
integer<int64>

The id of the parent blog post

contentTitle
string
collectionId
integer<int64>
createdAt
integer<int64>

Unix timestamp when the comment was made

deletedAt
integer<int64>
userName
string

The name of the person submitting the comment

firstName
string
lastName
string
userEmail
string

The email address of the user submitting the comment

userReferrer
string

The URL the comment was submitted from

userIp
string

The IP address of the person submitting the comment

userAgent
string

The user agent of the commenter's browser

userWebsite
string

The web site of the user submitting the comment

userUrl
string
comment
string

The full text of the comment

state
string

State of the comment; approved, rejected, etc.

contentAuthorEmail
string
contentAuthorName
string
contentCreatedAt
integer<int64>
threadId
string
replyingTo
string | null
parentId
integer<int64>
legacyId
integer<int64>
extraContext
object
parent
object
Last modified on December 12, 2025