Skip to main content
GET
/
cms
/
v3
/
blog-settings
/
settings
Get the list of blogs. Supports paging and filtering.
curl --request GET \
  --url https://api.hubapi.com/cms/v3/blog-settings/settings \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "absoluteUrl": "<string>",
      "allowComments": true,
      "created": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "htmlTitle": "<string>",
      "id": "<string>",
      "language": "af",
      "name": "<string>",
      "publicAccessRules": [
        {}
      ],
      "publicAccessRulesEnabled": true,
      "publicTitle": "<string>",
      "slug": "<string>",
      "translatedFromId": "<string>",
      "updated": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Professional
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Starter
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

after
string

The cursor token value to get the next set of results. You can get this from the paging.next.after JSON property of a paged response containing more results.

archived
boolean

The timestamp (ISO8601 format) when this Blog was deleted.

createdAfter
string<date-time>

Filters results to only those blogs created after this timestamp (ISO8601 format)

createdAt
string<date-time>

The timestamp (ISO8601 format) when this Blog was created.

createdBefore
string<date-time>

Filters results to only those blogs created before this timestamp (ISO8601 format)

limit
integer<int32>

Pagination criteria to set the max number of blogs to return in a request

sort
string[]

List of fields by which to sort. Each sort object specifies a property name and direction (ASCENDING, DESCENDING)

updatedAfter
string<date-time>

Filters results to only those blogs updated after this timestamp (ISO8601 format)

updatedAt
string<date-time>

The timestamp (ISO8601 format) when this Blog was updated.

updatedBefore
string<date-time>

Filters results to only those blogs created before this timestamp (ISO8601 format)

Response

successful operation

Response object for collections of blogs with pagination information.

results
object[]
required

Collection of blogs.

total
integer<int32>
required

Total number of blogs.

paging
object

Model definition for forward paging.

Last modified on December 8, 2025