Creates a new folder in the media storage

http
POST https://services.leadconnectorhq.com/medias/folder

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Body

NameTypeRequiredExampleDescription
altIdstringYessx6wyHhbFdRXh302LLNRAccount Id
altTypestringYesaccountType of entity (account only) Possible values: 'account'
namestringYesNew FolderName of the folder to be created
parentIdstringNo64af50c42d567a3b4f5989e0ID of the parent folder (optional)

Responses

200 - Returns the newly created folder object
  • altId (string, required): Account identifier that owns this folder Example: sx6wyHhbFdRXh302LLNR

  • altType (string, required): Type of entity that owns the folder Possible values: 'account' Example: account

  • name (string, required): Name of the folder Example: New Folder

  • parentId (string): ID of the parent folder (null for root folders) Example: 64af50c42d567a3b4f5989e0

  • type (string, required): Type of the object (always 'folder' for folders) Example: folder

  • deleted (boolean): Whether the folder has been deleted Example: False

  • pendingUpload (boolean): Whether there are pending uploads to this folder Example: False

  • category (string): Primary category of content stored in the folder Example: image

  • subCategory (string): Sub-category of content stored in the folder Example: logo

  • isPrivate (boolean): Whether the folder is private and not publicly accessible Example: False

  • relocatedFolder (boolean): Whether the folder has been moved from its original account Example: False

  • migrationCompleted (boolean): Whether the data migration process has been completed for this folder Example: True

  • appFolder (boolean): Whether this is a system-generated application folder Example: False

  • isEssential (boolean): Whether the folder is essential and should not be deleted Example: False

  • status (string): Current status of the folder

  • lastUpdatedBy (string): ID of the user who last updated the folder Example: user-uuid-123

json
{
  "altId": "sx6wyHhbFdRXh302LLNR",
  "altType": "account",
  "name": "New Folder",
  "parentId": "64af50c42d567a3b4f5989e0",
  "type": "folder",
  "deleted": false,
  "pendingUpload": false,
  "category": "image",
  "subCategory": "logo",
  "isPrivate": false,
  "relocatedFolder": false,
  "migrationCompleted": true,
  "appFolder": false,
  "isEssential": false,
  "status": "string",
  "lastUpdatedBy": "user-uuid-123"
}

Example

curl -X POST 'https://services.leadconnectorhq.com/medias/folder' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "altId": "sx6wyHhbFdRXh302LLNR",
  "altType": "account",
  "name": "New Folder",
  "parentId": "64af50c42d567a3b4f5989e0"
}'

Last updated October 26, 2026

Was this page helpful?