HUhubspot
Folders

Retrieve folder

Changed on

Retrieve folder metadata by its ID.

get/files/2026-09/folders/{folderId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/files/2026-09/folders/{folderId}
  • 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

Path parameters

folderIdstring required

The ID of the folder to retrieve.

Query parameters

propertiesstring[]

A comma-separated list of folder property names to include in the response.

Response

successful operation

archivedboolean required

A boolean indicating whether the folder is archived.

archivedAtstring date-time

The date and time when the folder was archived, in ISO 8601 format.

createdAtstring date-time required

The date and time when the folder was created, in ISO 8601 format.

idstring required

The unique ID for the folder, represented as a string.

namestring

The name of the folder, represented as a string.

parentFolderIdstring

The unique identifier of the parent folder, represented as a string.

pathstring

The path of the folder within the file system, represented as a string.

updatedAtstring date-time required

The date and time when the folder was last updated, in ISO 8601 format.

Changes

  • 2026-098f8b7750e626Revision changes
    • info

      api tag Folders added

    • info

      api tag Basic 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