HUhubspot
Basic

List posts

Changed on

Retrieve a list of blog posts with optional filtering and sorting capabilities. This endpoint supports pagination and allows you to specify date ranges for creation and update times, as well as sorting preferences. It is useful for obtaining an overview of blog posts, including archived ones if desired.

get/cms/blogs/2026-09/posts/cursor

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/cms/blogs/2026-09/posts/cursor
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: content

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

archivedboolean

Whether to return only results that have been archived.

createdAfterstring date-time

Filter posts created after a specific date and time.

createdAtstring date-time

Filter posts by their creation date and time.

createdBeforestring date-time

Filter posts created before a specific date and time.

limitinteger

The maximum number of results to display per page.

propertystring

Specify properties to include in the response.

sortstring[]

Specify the sorting order of the results. Accepts an array of field names.

updatedAfterstring date-time

Filter posts updated after a specific date and time.

updatedAtstring date-time

Filter posts by their last update date and time.

updatedBeforestring date-time

Filter posts updated before a specific date and time.

Response

successful operation

CursorPagedResultBlogPostLong required

Changes

  • 2026-09062fc4c57ddcRevision changes
    • info

      api operation id get-/cms/blogs/2026-09/posts/cursor_/cms/blogs/2026-09/posts/cursor removed and replaced with get-/cms/blogs/2026-09/posts/cursor_/cms/blogs/v3/posts/cursor

  • 2026-0964f654adebd9Revision changes
    • info

      endpoint added