Create Share

Create a new share to send files or request files

Parameters

Parameter	Type	Required	Description	Options
`share_type`	`string`	Required	Type of share: "Send" to share files, "Request" to request uploads	`SendRequest`
`items`	`array`	Optional	Array of item IDs to share (required for Send shares)	—
`parent_id`	`string`	Optional	Parent folder ID for Request shares (where uploads will go)	—
`title`	`string`	Optional	Title/subject for the share	—
`expiration_days`	`number`	Optional	Number of days until share expires (default varies by account)	—
`max_downloads`	`number`	Optional	Maximum number of downloads allowed (-1 for unlimited)	—
`require_login`	`boolean`	Optional	Require recipients to log in to access	—
`require_user_info`	`boolean`	Optional	Require recipients to provide name/email/company	—
`is_view_only`	`boolean`	Optional	View only mode (no download) for Send shares	—
`notify_on_download`	`boolean`	Optional	Send notification when files are downloaded	—
`notify_on_upload`	`boolean`	Optional	Send notification when files are uploaded (Request shares)	—
`recipients`	`array`	Optional	Array of recipient email addresses	—
`personal_message`	`string`	Optional	Personal message to include in notification emails	—
`cc_sender`	`boolean`	Optional	CC the sender on notification emails	—

Examples

MCP Tool Call

{
  "name": "sharefile_createShare",
  "arguments": {
    "share_type": "example",
    "items": "example",
    "parent_id": "example",
    "title": "example",
    "expiration_days": 12345,
    "max_downloads": 12345,
    "require_login": true,
    "require_user_info": true,
    "is_view_only": true,
    "notify_on_download": true,
    "notify_on_upload": true,
    "recipients": "example",
    "personal_message": "example",
    "cc_sender": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/createShare \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "share_type": "example",
  "items": "example",
  "parent_id": "example",
  "title": "example",
  "expiration_days": 12345,
  "max_downloads": 12345,
  "require_login": true,
  "require_user_info": true,
  "is_view_only": true,
  "notify_on_download": true,
  "notify_on_upload": true,
  "recipients": "example",
  "personal_message": "example",
  "cc_sender": true
}'