How to Find the Folder ID

Many API endpoints require you to indicate the Folder where you want to save a new item. The Folder ID is a unique, system-generated identifier for each folder and sub-folder in your system. This value is not displayed within the application user interface anywhere, so to get your Folder ID, you must retrieve it by means of the Search API endpoint.

  1. Submit a GET request to the Search endpoint. The easiest method is to use the version that lets you search by object type -- use a type value of "Folder."

  2. The response message provides a list of all the folders in your system. Find the desired folder in the response message.

  3. As part of the API response message, the system provides the Folder ID, which is referred to as the "obj_id."

Note: If this Folder is a sub-folder, the "parent_obj_id" is the Folder ID of the parent folder.

Sample Response:

  {

    "obj_id": 37465,

    "display_name": "Content Block Folder",

    "type_id": "Folder",

    "ref_id": 37465,

    "parent_obj_id": 22817,

    "eligibility_status_id": "READY"

  }