ghl_media_upload_file
Upload media files to GoHighLevel Media Storage from a local path or hosted URL, with separate size limits for images, documents, and video.
Instructions
multipart/form-data upload. body.file (binary) is required UNLESS body.hosted is true, in which case body.fileUrl is required instead. For local files, pass body.file as { filePath, filename?, mimeType? } — http.ts reads the file from disk and builds a real multipart payload (schema relaxed to allow this 2026-07-16; the earlier note claiming no multipart construction was stale/wrong per http.ts). Max 25MB (images/docs) / 500MB (video).
Upload File into Media Storage
If hosted is set to true then fileUrl is required. Else file is required. If adding a file, maximum allowed is 25 MB. For video files, the maximum allowed size is 500 MB.
Endpoint: POST /medias/upload-file (Version header: v3; source: v3/medias-v3.json)
Requires a Sub-Account (location) token.
OAuth scopes: medias.write
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"body": "<body>"
},
"name": "ghl_media_upload_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Request body (schema carried verbatim from the official OpenAPI spec). |