Skip to main content

Create Folder with Content

Purpose 

To create a new folder along with content.

HTTP Request URL

https://{zohoapis_domain}/writer/api/v1/folders/{{folder_id}}

Path Parameters

ParameterData TypeDescription
Mandatory Parameters
folder_idStringSpecify the id of the parent folder where the new folder needs to be created.

Body Parameters

ParameterData TypeDescription
Mandatory Parameters
folder_nameStringSpecify a name to the new folder to be created.
filenameStringSpecify the document name.
contentFileSpecify the required content in your API request body.

Sample Request

Copiedcurl --location --request POST "https://www.zohoapis.com/writer/api/v1/folders/egrjadd41d336806742cfa45a61528bb0210d" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form "folder_name=29Dec2018" \
  --form "content=@" \
  --form "filename=output filename"

Sample Response

Copied{
  "folder": {
    "created_time": "2019-02-27T11:20:01Z",
    "role": "OWNER",
    "modified_time_ms": 1551266401094,
    "parent_folder_id": "lh6rdc7b48962f48d480299f6d4afafe72fb3",
    "last_opened_time": "2019-02-27T11:20:01Z",
    "folder_name": "29Dec2018",
    "is_favourite": false,
    "last_opened_time_ms": 1551266401094,
    "type": "folder",
    "created_by": "Amelia",
    "created_time_ms": 1551266401094,
    "modified_time": "2019-02-27T11:20:01Z",
    "creator_id": "1308724",
    "folder_id": "h36bcb32d7262f06b4e2fb88cc48651ae4e8e",
    "lastmodified_by": [
      {
        "email_id": "amelia@zylker.com",
        "profile_photo": "https://contacts.zoho.com/file?t=user&ID=1308724&fs=thumb",
        "user_id": "1308724",
        "display_name": "Amelia"
      }
    ],
    "status": "active"
  },
  "document": {
    "role": "OWNER",
    "modified_time_ms": 1551266441894,
    "owner_id": "1308724",
    "open_url": "https://writer.zoho.com/writer/open/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "is_favourite": false,
    "document_id": "h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "last_opened_time_ms": 1551266439748,
    "thumbnail_url": "https://writer.lzoho.com/writer/thumbnail/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "type": "document",
    "document_name": "output filename",
    "modified_time": "2019-02-27T11:20:41Z",
    "library_id": 1,
    "download_url": "https://writer.zoho.com/api/v1/download/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "document_properties": "https://writer.zoho.com/api/v1/documents/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "lastmodified_by": [
      {
        "email_id": "amelia@zylker.com",
        "profile_photo": "https://contacts.zoho.com/file?t=user&ID=1308724&fs=thumb",
        "user_id": "1308724",
        "display_name": "Amelia"
      }
    ],
    "created_time": "2019-02-27T11:20:39Z",
    "parent_folder_id": "h36bcb32d7262f06b4e2fb88cc48651ae4e8e",
    "collaboration_id": "1203298696561310278",
    "last_opened_time": "2019-02-27T11:20:39Z",
    "created_by": "Amelia",
    "version": "1.0",
    "created_time_ms": 1551266439748,
    "preview_url": "https://writer.zoho.com/writer/preview/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "creator_id": "1308724",
    "permalink": "https://docsdev.zoho.com/file/h36bcaeb8aa116b9d4273bc06c00836c2fdfb",
    "status": "active"
  }
}

Show full

Show less