Validates the uploaded file in GCS and returns the public URL. Call this endpoint after successfully uploading the file to the signed URL.

http
POST https://services.leadconnectorhq.com/conversations/messages/upload/complete

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Body

NameTypeRequiredExampleDescription
uploadIdstringYesa1b2c3d4-e5f6-7890-abcd-ef1234567890Upload ID from request response
filePathstringYesaccount/loc123/conversations/conv456/uuid.mp4File path from request response
locationIdstringYesve9EPM428h8vShlRW1KTAccount ID
conversationIdstringYesve9EPM428h8vShlRW1KTConversation ID
filenamestringYesvideo.mp4Original filename (for response mapping)

Responses

200 - Upload completed successfully
  • uploadedFiles (object, required): Map of filename to public URL

  • metadata (object, required): File metadata

json
{
  "uploadedFiles": {
    "video.mp4": "https://your-domain.com/conversations-assets/account/.../video.mp4"
  },
  "metadata": {
    "size": 52428800,
    "contentType": "video/mp4"
  }
}
400 - Bad Request - Invalid parameters
401 - Unauthorized
json
{}
404 - File not found in storage - upload may have failed or URL expired

Example

curl -X POST 'https://services.leadconnectorhq.com/conversations/messages/upload/complete' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
  "uploadId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "filePath": "account/loc123/conversations/conv456/uuid.mp4",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "conversationId": "ve9EPM428h8vShlRW1KT",
  "filename": "video.mp4"
}'

Last updated October 26, 2026

Was this page helpful?