Skip to main content
The Assets API lets you upload media files to Connectly’s CDN and retrieve their stable CDN URLs. Instead of hosting media yourself and worrying about availability, you provide a source URL and Connectly fetches and stores the file — returning a CDN URL you can use reliably in templates, campaigns, and messages.

​
How it works

1

Upload your asset

Call Create asset with a publicly accessible URL of your file. Connectly fetches the file and stores it on the CDN.
2

Save the CDN URL

The response includes asset.uri — a stable CDN URL hosted by Connectly. Store this alongside your asset records.
3

Use it in templates or messages

Pass asset.uri as the value for header_image, header_document, or any attachment URL in your template and session message requests.
4

Retrieve it later

If you only saved the asset ID, use Get asset to look up the CDN URL at any time.
The source URL you provide must be publicly accessible from Connectly’s servers. Private, authenticated, or localhost URLs will fail with a 400 error.

​
Endpoints

Create asset

POST /v1/businesses/{businessId}/assets — upload a file by source URL and get a CDN URL back.

Get asset

GET /v1/businesses/{businessId}/assets/{assetId} — retrieve the CDN URL for an existing asset by ID.