Ads API •References / assets / Create Asset
Create Asset
Creates an asset belonging to provided ad account and returns asset metadata. 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_typestringRequired
The type of asset.
Example value:"IMAGE"
Allowed values:"AUDIO"
,"IMAGE"
,"VIDEO"
- asset_subtypestringExample value:
"COMPANION"
Allowed values:"COMPANION"
,"LOGO"
,"USER_UPLOADED_AUDIO"
- namestringRequired
The name of the asset file.
Example value:"logoImage.png"
Length between2
and120
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"}