Ads API •References / assets / Upload Asset
Upload Asset
Uploads an asset to storage and returns asset metadata. Supports uploads of files up to 20MB in size. Asset type can be either image, audio, or video.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- asset_idstring [uuid]Required
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- mediastring [binary]RequiredSupported content-type(s):
image/png, image/jpeg, audio/ogg, audio/mp3, audio/wav, audio/mpeg, audio/x-wav, video/mp4, video/quicktime
- asset_typestringRequired
The type of asset.
Example value:"IMAGE"
Allowed values:"AUDIO"
,"IMAGE"
,"VIDEO"
Response
The newly created asset metadata
Metadata object for an image asset type.
Metadata object for an audio asset type.
Metadata object for a video asset type.
Response sample
{ "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "name": "logoImage.png", "assetType": "IMAGE", "status": "READY", "url": "https://i.scdn.co/image/123", "created_at": "2026-01-23T04:56:07Z", "updated_at": "2026-01-23T04:56:07Z", "image_type": "COMPANION", "file_type": "JPEG"}