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/completeAuthorization
| 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 |
|---|---|---|---|---|
uploadId | string | Yes | a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Upload ID from request response |
filePath | string | Yes | account/loc123/conversations/conv456/uuid.mp4 | File path from request response |
locationId | string | Yes | ve9EPM428h8vShlRW1KT | Account ID |
conversationId | string | Yes | ve9EPM428h8vShlRW1KT | Conversation ID |
filename | string | Yes | video.mp4 | Original filename (for response mapping) |
Responses
200 - Upload completed successfully
uploadedFiles(object, required): Map of filename to public URLmetadata(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
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"
}'const response = await fetch('https://services.leadconnectorhq.com/conversations/messages/upload/complete', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
Version: '2021-07-28',
'Content-Type': 'application/json',
},
body: JSON.stringify({"uploadId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "filePath": "account/loc123/conversations/conv456/uuid.mp4", "locationId": "ve9EPM428h8vShlRW1KT", "conversationId": "ve9EPM428h8vShlRW1KT", "filename": "video.mp4"}),
});
const data = await response.json();import os, requests
response = requests.request(
'POST',
'https://services.leadconnectorhq.com/conversations/messages/upload/complete',
headers={
'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
'Version': '2021-07-28',
'Content-Type': 'application/json',
},
json={"uploadId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "filePath": "account/loc123/conversations/conv456/uuid.mp4", "locationId": "ve9EPM428h8vShlRW1KT", "conversationId": "ve9EPM428h8vShlRW1KT", "filename": "video.mp4"},
)
data = response.json()<?php
$ch = curl_init('https://services.leadconnectorhq.com/conversations/messages/upload/complete');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
'Version: 2021-07-28',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode({'uploadId': 'a1b2c3d4-e5f6-7890-abcd-ef1234567890', 'filePath': 'account/loc123/conversations/conv456/uuid.mp4', 'locationId': 've9EPM428h8vShlRW1KT', 'conversationId': 've9EPM428h8vShlRW1KT', 'filename': 'video.mp4'}),
]);
$data = json_decode(curl_exec($ch), true);