clickup_create_entity_attachment
Upload a local file to a ClickUp task or File-type Custom Field. This is the modern method that replaces older attachment tools and is required for uploading to custom fields.
Instructions
Upload a local file to a task or File-type Custom Field (v3).
Reads the file at file_path and posts it as multipart/form-data to
POST /v3/workspaces/{workspace_id}/{entity_type}/{entity_id}/attachments.
After uploading to a Custom Field (entity_type='custom_fields'), call
clickup_set_custom_field_value to associate the uploaded file with a task.
When to Use:
The modern replacement for
clickup_create_task_attachment, and the only way to upload to a File-type Custom Field.
When NOT to Use:
To read existing attachments — use
clickup_get_entity_attachments.
Returns: A confirmation with the new attachment's id and URL (never the file bytes).
Examples:
task:
params = {"workspace_id": "123", "entity_type": "attachments", "entity_id": "abc", "file_path": "/tmp/a.png"}custom field:
params = {"workspace_id": "123", "entity_type": "custom_fields", "entity_id": "fld-1", "file_path": "./a.png"}
Error Handling:
A ValidationError before the request means the path is missing/empty/too
large; a 404 means the entity_id was not found — or the v3 attachments
surface is not available on this Workspace (verified live: some plans 404
on this endpoint entirely; use clickup_create_task_attachment for task
files in that case).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |