Clay API Docs
  1. Folders
Clay API Docs
  • Disclaimer
  • Authentication
    • Fetch Clay Cookies
      POST
  • Workspaces
    • Get All Workspaces in your account
      GET
  • Folders
    • Create a folder
      POST
    • Delete a folder
      DELETE
  • Resources
    • Fetch all resources
      POST
    • Search a resource in workspace
      POST
  • Workbooks
    • Create a Workbook
      POST
    • Delete a Workbook
      DELETE
  • Tables
    • Fetch all record ids in a table
      GET
    • Add a row in the table
      POST
    • Delete a row from the table
      DELETE
    • Delete all rows from a table
      DELETE
    • Run an enrichment column
      PATCH
    • Count number of row in a Table
      GET
  • Credit Usage
    • Get a list of owners
      GET
    • Get User-Specific Credit Usage Report
      GET
    • Get User-Created Resources
      POST
    • Get Workspace Credit Usage Report
      GET
    • List all integrations
      GET
    • Get Integration Type Details
      GET
    • Get Integration-Specific Credit Usage
      GET
    • Get Integration Credit Usage Report
      GET
  • Schemas
    • Sample Schemas
      • Pet
      • Category
      • Tag
  1. Folders

Create a folder

Developing
POST
https://api.clay.com/v3/workspaces/{YOUR_CLAY_WORKSPACE_ID}/folders

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.clay.com/v3/workspaces/<YOUR_CLAY_WORKSPACE_ID>/folders' \
--header 'Cookie: YOUR_CLAY_COOKIES' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string"
}'
Response Response Example
{
    "id": "f_0swrerethniZu5TCS",
    "workspaceId": 54643,
    "name": "TEST",
    "orderValue": "6",
    "parentFolderId": null,
    "createdAt": "2025-05-23T12:05:12.653Z",
    "updatedAt": "2025-05-23T12:05:12.653Z",
    "deletedAt": null,
    "abilities": {
        "canDelete": true,
        "canUpdate": true
    }
}
Modified at 2026-01-14 06:49:17
Previous
Get All Workspaces in your account
Next
Delete a folder
Built with