Skip to content
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_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • asset_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • media
    string [binary]
    Required
    Supported content-type(s): image/png, image/jpeg, audio/ogg, audio/mp3, audio/wav, audio/mpeg, audio/x-wav, video/mp4, video/quicktime
  • asset_type
    string
    Required

    The type of asset.

    Example value: "IMAGE"Allowed values: "AUDIO", "IMAGE", "VIDEO"

Response

The newly created asset metadata

Will be one of the following:
  • 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"}