CUcustomer
Folders

Create a folder

Changed on

Create a new folder at the root level or under a parent folder. To create a child folder, you need the UUID of the parent folder, which you can retrieve with List folders.

post/v1/design_studio/folders

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/design_studio/folders
  • Auth
    HTTP bearer

Request body

namestring required

The name of the folder. Cannot contain these characters: < > : " / \ | ? * .

parent_folder_idstring uuid nullable

UUID of the parent folder. Omit or pass null to create at root.

Example request

{
  "name": "Product Announcements"
}

Response

Folder created

Example response

{
  "folder": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Product Announcements",
    "parent_folder_id": null,
    "created": 1714732800,
    "updated": 1714732800
  }
}

Changes

  • 6378ded43e43Revision changes
    • info

      the endpoint scheme security Bearer-Auth was added to the API

    • info

      api tag Folders added

    • info

      api tag Design Studio removed

  • b0a0db5fbc21Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status