Method Details
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a new comment.
There's a new version of the HubSpot API
Starting November 30, 2022, API keys will be sunset as an authentication method. Learn more about this change and how to migrate an API key integration to use a private app instead.
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a new comment.
| Required Parameters | How to use | Description |
|---|---|---|
| OAuth Access Token or API Key | Authorization: Bearer {token} header or hapikey={key} query parameter. |
Used to authenticate the request. Please see this page for more details about authentication. |
Hit this URL with a HTTP method of POST http://api.hubapi.com/comments/v3/comments?hapikey=demo
This API is considered content agnostic, meaning it may record data for more than a single type of object (a blog post or a landing page, etc.) Due to this difference, the API requires additional fields that may seem redundant if the API were only concerned with a single type.
| Parameter name | Type | Description |
|---|---|---|
| comment | string | The full text of the comment |
| contentId | long | The id of the parent blog post |
| collectionId | long | The ID of the blog that the post is a part of. You can get the blog ID through the Blog API |
| contentAuthorEmail | string | The email address of the blog post author |
| contentAuthorName | string | The name of the blog post author |
| contentPermalink | string | URL to the blog post |
| contentTitle | string | Title of the blog post |
| userEmail | string | The email address of the comment author |
| userName | string | The name of the comment author |
| userUrl | string | The homepage of the comment author (Optional) |