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 blog topic.
There's a new version of the HubSpot API
We're also working on a new documentation website, you're invited to check it out and give us your feedback.
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a new blog topic.
| Required Parameters | How to use | Description |
|---|---|---|
| OAuth access token or private app access token | Authorization: Bearer {token} header | Used to authenticate the request. Please see this page for more details about authentication. |
| Parameter name | Description |
|---|---|
| casing | Use the casing=snake parameter to change the API's casing for allowed JSON fields (below) to snake_case, rather than camelCase, which is the default. This option is provided for backwards-compatibility and ease of migration from Content v2 APIs, which used snake_case. |
| Field name | Type | Description |
|---|---|---|
| name | string | The topic name |
| description | string | The topic description |
Example POST body:
{ "name": "Hey A New Topic", "description": "This is a topic description" }Example POST response:
HTTP/1.1 201 Created { "id": 349001123123123, "portalId": 62515, "name": "Hey a new topic", "slug": "hey-a-new-topic", "description": "This is a topic description", "created": 1381896200000, "updated": 1381896200000, "deletedAt": 0, "totalPosts": null, "livePosts": null, "lastUsed": null, "associatedBlogIds": [ ], "publicUrl": null, "status": "inactive" }