Boltly Boltly / Docs
Docs / API Reference / File Upload

File Upload

Upload media for messages and CSV files for bulk contact import. Files are stored securely and returned with a URL you can reference in other API calls.

POST /v1/uploads

Upload file

Upload a media file (image, video, document, audio) or a CSV for contact import. Send as multipart/form-data. Max file size is 32 MB.

Parameters

file file required

The file to upload, sent as a multipart form field.

generate_cdn boolean

Generate a CDN link for the uploaded file. Defaults to false.

Request

cURL
curl -X POST https://api.boltly.online/v1/uploads \
  -H "X-API-Key: $API_KEY" \
  -F "file=@/path/to/product-photo.jpg" \
  -F "generate_cdn=true"

Response

JSON
{
  "data": {
    "s3_url": "https://s3.amazonaws.com/boltly-uploads/org_4f1a.../product-photo.jpg",
    "cdn_url": "https://cdn.boltly.online/org_4f1a.../product-photo.jpg",
    "file_name": "product-photo.jpg",
    "file_size": 245678,
    "content_type": "image/jpeg"
  }
}