Home/HighLevel/Features/Conversations/HighLevel signed URL file upload: how it works

Conversations and Inbox

HighLevel signed URL file upload: how it works

In short

Signed URL File Upload replaces server buffered transfers with direct client to Google Cloud Storage streams. It issues a short lived signed URL, lets the client PUT the file, then verifies it, delivering a public link while reducing memory load and supporting larger media sizes.

AreaConversations · Conversations
Used forMarketing agency, Ecommerce retailer, Healthcare clinic
Setup steps3 steps in 1 task
Last updatedNovember 17, 2026

01Who this is for

  • Product teams building messaging intensive SaaS platforms benefit because the flow prevents out of memory crashes during file uploads.
  • Marketing teams that send large media via WhatsApp gain faster delivery and fewer upload errors.
  • Support departments handling customer screenshots and videos avoid server load spikes with direct client uploads.

02Signed URL file uploads, explained

Signed URL File Upload is an infrastructure change within the Conversations API. Instead of routing file bytes through HighLevel servers, the platform returns a time limited, signed URL that points to a Google Cloud Storage object. The client then streams the file straight to GCS.

The upload proceeds in three distinct phases: Initiate, where metadata is posted and a signed URL is generated; Upload, where the client performs a PUT request directly to the signed URL; and Complete, where HighLevel confirms the stored object and returns a public link for use in messages. The signed URL expires after 15 minutes, and the system validates size, MIME type, and access rights at each step.

03How businesses use signed URL file upload

  • Marketing agency. The agency creates a media post for a client’s WhatsApp campaign. It first calls the Initiate endpoint with file metadata, receives a signed URL, uploads the video directly to GCS, then calls Complete to obtain the URL that will be inserted into the WhatsApp message.
  • Ecommerce retailer. When a customer requests a product demo video via SMS, the retailer initiates the upload flow, streams the video file straight to GCS, and completes the process to embed the public link in the outgoing SMS, keeping the server free of large file buffers.
  • Healthcare clinic. The clinic’s portal allows patients to attach medical documents to a chat. The portal initiates a signed URL request, uploads the PDF directly to GCS, and completes the upload to receive a secure link that can be shared within the encrypted conversation.

04The numbers and rules that matter

  • WhatsApp uploads up to 100 MB.
  • Other channels up to 5 MB.
  • Signed URLs expire after 15 minutes.

05How to set up and use signed URL file upload in HighLevel

Execute the three step Signed URL upload flow

  1. Call POST /conversations/messages/upload/initiate with file name, size, and content type to receive a signed URL and object path.
  2. Send a PUT request from the client to the signed URL, streaming the file bytes and setting the Content Type header to match the file.
  3. Call POST /conversations/messages/upload/complete with the object path so HighLevel verifies the stored file and returns the public URL for messaging.

06Settings that matter

  • Signed URL lifetime. Controls how long the generated upload URL remains valid; it expires after 15 minutes to limit misuse.
  • Channel size limits. Defines maximum allowed media size per messaging channel: up to 100 MB for WhatsApp and up to 5 MB for all other channels.
  • Content, Type validation. Ensures the declared MIME type matches the file extension on Initiate and that the stored object's MIME type matches the filename on Complete.

07Things to know before you rely on it

  • WhatsApp supports media files up to 100 MB; all other channels are limited to 5 MB.
  • Signed URLs expire after 15 minutes and cannot be reused for additional files.
  • Files larger than the channel limit are rejected during the Initiate step.
  • Mismatched MIME types cause validation failures at both Initiate and Complete stages.

08If something goes wrong

  • Signed URL expires before upload finishes. Repeat the Initiate call to obtain a fresh signed URL, then resume the upload and complete steps.
  • File size exceeds channel limit. Reduce the file size or choose a channel that allows a larger limit, such as WhatsApp for up to 100 MB.
  • Content type mismatch error. Ensure the file extension and the Content Type header accurately describe the file before calling Initiate.
  • Permission or path validation failure. Verify that the conversation exists, belongs to the specified location, and that the user has access to that location.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Get the Initiate request as close as possible to the actual upload. That way the 15 minute window is fully available and you avoid unnecessary retries.

Test the Content Type header handling early, because mismatches will stop the flow before any data moves.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 17, 2026

Common questions

Common questions about signed URL file upload.

Is the “Complete” call required?

Yes. The Complete step verifies that the object was stored correctly and returns the public URL used in messages.

What happens if the signed URL expires during upload?

The upload must be restarted by calling Initiate again to receive a new signed URL, then proceeding with the upload and complete steps.

Are objects public after the Complete step?

The Complete response includes a public URL. Share it according to your organization’s data handling policies.

How long does a signed URL remain valid?

Each signed URL is time limited to 15 minutes.

Can the same signed URL be used for multiple files?

No. Every Initiate request generates a unique URL tied to a specific file path and expiration time.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.