Skip to main content
GHL MCP Guide
MDA

Media Library

Content & Email · Basic · Updated March 2026

Upload, list, and delete files in the media library. Supports images, videos, and documents used across blogs, social posts, emails, and funnels.

Every image in a blog post, every video in a social update, every photo in an email template has to be hosted somewhere. GHL’s Media Library is that somewhere. Managing it through MCP means you can build upload pipelines that automatically push media assets from external systems — design tools, AI image generators, photography workflows — into GHL where they’re ready to use across every content surface.

What This MCP Tool Does

Upload files to the location’s media library, list all stored media, and delete files no longer needed. Uploaded media gets a hosted URL that can be referenced in blog posts, social posts, emails, funnels, and anywhere else that accepts media URLs.

Endpoint Reference

List media: GET /medias Upload a file: POST /medias/upload-file Delete media: DELETE /medias/{mediaId}

Authentication

Requires a Private Integration Token (PIT) with the medias scope enabled.

Key Parameters

  • file — the file to upload (multipart form data)
  • name — optional display name for the file

Important Notes

Uploaded files are stored on GHL’s CDN and given permanent URLs. These URLs can be used in any content context: blog featured images, social post media, email templates, funnel page images.

Common file types: JPEG, PNG, GIF, WebP for images. MP4 for video. PDF, DOC for documents. Check GHL’s documentation for the complete list of supported formats.

The media library is shared across the entire location. Files uploaded for a blog post are available in the social planner, email builder, and funnel editor. Upload once, use everywhere.

Storage limits may apply depending on your GHL plan. Monitor usage for locations with heavy media requirements.

Common Questions

Can I upload media programmatically from an AI image generator? Yes. Generate the image, save it, upload via MCP, and use the returned URL in your blog posts or social content.

Are there file size limits? Yes. Exact limits depend on file type and GHL plan. Keep images optimized and videos compressed for reliable uploads.

Can I organize media into folders? Folder organization may be available through the UI. MCP access is flat — all media is listed together.

What URL format do uploaded files get? GHL provides CDN-hosted URLs. The exact format varies but they’re publicly accessible and permanent.

Back to GHL MCP Guide