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

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • asset_type
    string
    Required

    The type of asset.

    Example value: "IMAGE"Allowed values: "AUDIO", "IMAGE", "VIDEO"
  • asset_subtype
    string
    Example value: "COMPANION"Allowed values: "COMPANION", "LOGO", "USER_UPLOADED_AUDIO"
  • name
    string
    Required

    The name of the asset file.

    Example value: "logoImage.png"Length between 2 and 120

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"}