Subfolders

After you create a creative asset business folder, you can add subfolders to help you organize your assets.

Permissions

You will need the folllowing:

• business_creative_management to create subfolders

Retrieve Subfolders

Example request

curl -X GET \
"https://graph.facebook.com/v24.0/<PARENT_FOLDER_ID>/subfolders?fields=<FOLDER_NAME>&access_token=<ACCESS_TOKEN>"

Example response

{
  "data": [
    {
      "name": "<SUBFOLDER_NAME>",
      "id": "<SUBFOLDER_ID>"
    }
  ]
}

Filtering

You can filter the subfolders using the name_or_id field with the CONTAIN operator.

Example request

curl -X GET \
"https://graph.facebook.com/v24.0/<PARENT_FOLDER_ID>/subfolders?filtering=[{"field":"name_or_id","operator":"CONTAIN","value":"<SEARCH_VALUE>"}]&access_token=<ACCESS_TOKEN>"

Create Subfolders

Example request

curl -X POST \
  -F "name=<FOLDER_NAME>"
  -F "description=<DESCRIPTION>"
  -F "parent_folder_id=<PARENT_FOLDER_ID>"
  -F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v24.0/<BUSINESS_ID>/creative_folders"

Example response

{
  "id": "<SUBFOLDER_ID>"
}

Note: The <SUBFOLDER_ID> can be used during the creative asset upload process. This works the same as it would if you added a creative asset to the parent folder.

Delete Subfolders

Folders and subfolders can be deleted with a DELETE request to the /<FOLDER_ID> or the /<SUBFOLDER_ID> endpoint.