Add an asset to the creative library

Changed on

Saves an existing Open Cloud image asset to the creative library ahead of campaign creation. Dimensions and moderation state are derived by the service. Registering an asset that is already active in the selected billing account's library returns 409 ALREADY_EXISTS, regardless of the supplied universeId. You cannot change an active entry's universeId by re-registering the asset. Archived entries are unarchived and updated with the supplied fields.

post/ads-management/v1/creatives

Request

  • Base URL
    https://apis.roblox.com
  • Auth
    • API key in cookie .ROBLOSECURITY
    • or API key in header x-api-key
    • or OAuth 2
      Authorization codehttps://apis.roblox.com/oauth/v1/authorize
      Token URLhttps://apis.roblox.com/oauth/v1/token
      Scopesad.campaign:write

Query parameters

groupIdstring

Select the group ads account; absent groupId selects the personal ads account. Requires group advertising permission

Request body

assetIdstring required

The Roblox image asset ID to save to the selected ads account, as a decimal string. groupId selects the group ads account; absent groupId selects the personal ads account.

universeIdstring

Optional experience to associate the creative with, as a decimal string.

Response

Creative created

assetIdstring

The Roblox asset ID identifying this creative, as a decimal string. Use this assetId in GET and PATCH /creatives/{id}, not the registration UUID in id. groupId selects the group ads account; absent groupId selects the personal ads account.

assetNamestring

The display name of the underlying asset.

assetType'IMAGE'

The media type of the asset. Only IMAGE is supported.

billingAccountIdstring

The billing account whose library holds this entry.

createTimestring date-time

The time the creative was added to the library, as an RFC 3339 UTC timestamp.

heightinteger

The height of the asset in pixels. Omitted when unknown.

idstring uuid

The UUID identifying this creative registration. GET and PATCH paths use assetId, not this UUID.

isArchivedboolean

Whether the creative has been archived (soft-deleted).

moderationStatus'PENDING_REVIEW' | 'APPROVED' | 'REJECTED'

The content-review outcome for the asset. Can be PENDING_REVIEW, APPROVED, or REJECTED.

source'UPLOAD' | 'IN_HOUSE_GEN_AI'

How the asset was produced. Can be UPLOAD or IN_HOUSE_GEN_AI.

universeIdstring

The identifier of the experience the creative is associated with, if any, as a decimal string. Omitted when not associated with an experience.

updateTimestring date-time

The time the creative was last updated, as an RFC 3339 UTC timestamp.

widthinteger

The width of the asset in pixels. Omitted when unknown.

Changes