---
title: "Add an asset to the creative library"
method: POST
path: "/ads-management/v1/creatives"
---

# Add an asset to the creative library

`POST /ads-management/v1/creatives`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/creatives`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `ad.campaign:write`

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.

## Query parameters

- `groupId` string

## Request body

- CreateCreativeRequest
  - `assetId` string, 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.
  - `universeId` string: Optional experience to associate the creative with, as a decimal string.

## Response `201`

Creative created

- Creative
  - `assetId` string: 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.
  - `assetName` string: The display name of the underlying asset.
  - `assetType` 'IMAGE': The media type of the asset. Only `IMAGE` is supported.
  - `billingAccountId` string: The billing account whose library holds this entry.
  - `createTime` string, date-time: The time the creative was added to the library, as an RFC 3339 UTC timestamp.
  - `height` integer: The height of the asset in pixels. Omitted when unknown.
  - `id` string, uuid: The UUID identifying this creative registration. GET and PATCH paths use assetId, not this UUID.
  - `isArchived` boolean: 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`.
  - `universeId` string: The identifier of the experience the creative is associated with, if any, as a decimal string. Omitted when not associated with an experience.
  - `updateTime` string, date-time: The time the creative was last updated, as an RFC 3339 UTC timestamp.
  - `width` integer: The width of the asset in pixels. Omitted when unknown.

## Other responses

- `400`: Invalid request or asset not usable
- `403`: Permission denied
- `409`: Asset already registered in the selected billing account's library
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/creatives/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/a94d3bd77d7f?raw)
