HUhubspot
Folders

Search folders

Changed on

Search for folders in the HubSpot file manager using various query parameters to filter results. This endpoint allows you to retrieve folders based on specific criteria such as creation date, update date, folder name, and parent folder IDs. It supports pagination and sorting to help manage large sets of data efficiently.

get/files/2026-09/folders/search

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/files/2026-09/folders/search
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: files.ui_hidden.read

Query parameters

afterstring

A cursor token for pagination. Use the value from the previous response's paging.next.after field.

beforestring

A cursor token for pagination. Use the value from the previous response's paging.prev.before field.

createdAtstring date-time

Filter folders created at this exact epoch timestamp.

createdAtGtestring date-time

Filter results where the creation date is greater than or equal to this epoch timestamp.

createdAtLtestring date-time

Filter results to folders created before or at this epoch timestamp.

idGteinteger

Filter results to include only folders with IDs greater than or equal to this value.

idLteinteger

Filter to include folders with IDs less than or equal to this value.

idsinteger[]

A list of folder IDs to filter the results.

limitinteger

The maximum number of results to display per page.

namestring

Filter folders by this name.

parentFolderIdsinteger[]

A list of parent folder IDs to filter the results.

pathstring

Filter results to folders with this specific path.

propertiesstring[]

A list of property names to include in the response.

sortstring[]

A list of property names to sort by in the response.

updatedAtstring date-time

Filter results to include only folders updated at this exact epoch timestamp.

updatedAtGtestring date-time

Filter results to folders updated at or after this epoch timestamp.

updatedAtLtestring date-time

Filter folders updated at or before this epoch timestamp.

Response

successful operation

Changes

  • 2026-098f8b7750e626Revision changes
    • info

      api tag Folders added

    • info

      api tag Search removed

  • 2026-096e0d1e97cb30Revision changes
    • info

      the security scope files.ui_hidden.read was added to the endpoint's security scheme oauth2

    • info

      the security scope files.read was removed from the endpoint's security scheme oauth2