Meta Developer Docs

Appearance

Fresh 2026

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 ​

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

Example response ​

json
{
  "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 ​

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

Create Subfolders ​

Example request ​

html
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/v25.0/<BUSINESS_ID>/creative_folders"

Example response ​

json
{
  "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.