Get /crm/v3/lists/folders /crm/v3/lists/folders

Retrieves a folder.

GET/crm/v3/lists/folders

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Get /crm/v3/lists/folders /crm/v3/lists/folders action (under Lists).
Fill in the fields below, then reference the result from later steps as {{getCrmV3ListsFoldersCrmV3ListsFolders.response.data}}.

Request

Query parameters

folderIdstring

The Id of the folder to retrieve.

Default "0"

Response

Returns 200 with an object. Read it in later steps with {{getCrmV3ListsFoldersCrmV3ListsFolders.response.data.<field>}}.

folderobject

childListsarray<integer (int32)>required

An array of list Id's contained in this folder.

childNodesarray<object>required

createdAtstring (date-time)

The time the folder was created at.

idstringrequired

The Id of the folder.

namestring

The name of the folder.

parentFolderIdstringrequired

The Id of the folder this folder is in, the root folder is represented as 0.

updatedAtstring (date-time)

The time the folder was last updated at.

updatedContentsAtstring (date-time)

The time that the contents of the folder was last updated at.

userIdinteger (int32)

The user Id of the owner of the folder.

json

{
  "folder": {
    "childLists": [
      0
    ],
    "childNodes": [
      {}
    ],
    "id": "string",
    "parentFolderId": "string",
    "createdAt": "2025-01-01T00:00:00Z",
    "name": "string",
    "updatedAt": "2025-01-01T00:00:00Z",
    "updatedContentsAt": "2025-01-01T00:00:00Z",
    "userId": 0
  }
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?