Search

Search folders

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-beta/folders/search

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