Generates a signed URL for direct file upload to Google Cloud Storage. Returns a signed URL valid for 15 minutes. Upload file via PUT request, then call /complete to finalize.
Generates a signed URL for direct file upload to Google Cloud Storage. Returns a signed URL valid for 15 minutes. Upload file via PUT request, then call /complete to finalize.
http
POST https://services.leadconnectorhq.com/conversations/messages/upload/initiate
Authorization
Name
Type
Required
Example
Description
Authorization
string
Yes
Bearer token generated from the Leadway portal. See Authentication.
Version
string
Yes
2021-07-28
API version.
Body
Name
Type
Required
Example
Description
locationId
string
Yes
ve9EPM428h8vShlRW1KT
Account ID
conversationId
string
Yes
ve9EPM428h8vShlRW1KT
Conversation ID
filename
string
Yes
video.mp4
Original filename with extension
contentType
string
Yes
video/mp4
MIME type of the file
fileSize
number
No
52428800
File size in bytes (optional, for pre-validation)
channel
string
Yes
WHATSAPP
Channel type for size limits (WHATSAPP for 100MB limit, others for 5MB)
Responses
200 - Signed URL generated successfully
uploadUrl (string, required): Signed URL for direct upload to GCS. Use PUT request with file content. Example: https://storage.googleapis.com/bucket/path?X-Goog-Algorithm=...
uploadId (string, required): Unique upload ID for tracking and completing the upload Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
filePath (string, required): File path in GCS bucket (needed for confirmation endpoint) Example: account/loc123/conversations/conv456/uuid.mp4