Skip to main content

Create Folder with Web URL Content

Purpose 

To create a new folder along with the content of the web URL.

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.
urlStringSpecify the web URL from which the content needs to be uploaded (to the new folder) 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=oneeeeewwww" \
  --form "url=https://calibre-ebook.com/downloads/demos/demo.docx" \
  --form "filename=output filename"

Sample Response

Copied{
  "folder": {
    "created_time": "2019-02-27T11:22:00Z",
    "role": "OWNER",
    "modified_time_ms": 1551266520570,
    "parent_folder_id": "lh6rdc7b48962f48d480299f6d4afafe72fb3",
    "last_opened_time": "2019-02-27T11:22:00Z",
    "folder_name": "text_folder",
    "is_favourite": false,
    "last_opened_time_ms": 1551266520570,
    "type": "folder",
    "created_by": "Amelia",
    "created_time_ms": 1551266520570,
    "modified_time": "2019-02-27T11:22:00Z",
    "creator_id": "1308724",
    "folder_id": "h36bcb93991e9327b4f71a6cf6e1de5022893",
    "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": 1551266521633,
    "owner_id": "1308724",
    "open_url": "https://writer.zoho.com/writer/open/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "is_favourite": false,
    "document_id": "h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "last_opened_time_ms": 1551266520953,
    "thumbnail_url": "https://writer.zoho.com/writer/thumbnail/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "type": "document",
    "document_name": "output filename",
    "modified_time": "2019-02-27T11:22:01Z",
    "library_id": 1,
    "download_url": "https://writer.zoho.com/api/v1/download/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "document_properties": "https://writer.zoho.com/api/v1/documents/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "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:22:00Z",
    "parent_folder_id": "h36bcb93991e9327b4f71a6cf6e1de5022893",
    "collaboration_id": "1203298696568325167",
    "last_opened_time": "2019-02-27T11:22:00Z",
    "created_by": "Amelia",
    "version": "1.0",
    "created_time_ms": 1551266520953,
    "preview_url": "https://writer.zoho.com/writer/preview/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "creator_id": "1308724",
    "permalink": "https://docsdev.zoho.com/file/h36bc140de7af48564a4e9ff5ef48ade1a37d",
    "status": "active"
  }
}

Show full

Show less