---
title: "Create asset(s)"
method: POST
path: "/media_library/businesses/{business_id}/assets"
tags: ["media_library"]
---

# Create asset(s)

`POST /media_library/businesses/{business_id}/assets`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/media_library/businesses/{business_id}/assets`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `ads:write`

Create one or more media library assets for a business. Assets are reusable
image or video creatives at the business level, not Pins. Use them later in
ads without creating a Pin first.

Before creating a media library asset:
- [Register the media upload](/docs/api/v5/media-create/).
- Upload the asset file to the Pinterest Media AWS bucket using the URL and
  metadata returned to you in the preceding step.
- [Confirm the upload](/docs/api/v5/media-get/).

Get [detailed steps for uploading assets](/docs/work-with-ads/manage-media-library-assets/).

You will use the `media_id` returned in the first step to create the media
library asset in this endpoint.

A request with multiple assets succeeds if at least one asset is created,
even if the others fail.

## Path parameters

- `business_id` string, required

## Request body

- MediaLibraryAssetsCreateRequest: Bulk create request: the assets to create. At most 100 assets may be created per request.
  - `assets` MediaLibraryAssetCreateEntry[], required: Assets to create
    - `media_id` string: Unique identifier returned when you registered the media upload via POST /v5/media.
    - `name` string, required: Name of the asset.
    - `ad_account_id` string: Ad account that created the asset
    - `tags` string[]: Words to categorize the assets so that you can filter on these categories later when fetching assets.

## Response `200`

The request has succeeded.

- MediaLibraryAssetsCreateResult: Bulk create result: the overall outcome plus the per-asset results.
  - `bookmark` string, nullable
  - `items` CreateMediaLibraryAssetResult[], required
    - `status` 'SUCCESS' | 'ERROR', required: Asset operation status for a single item in a bulk operation.
    - `error_code` 'ASSET_NOT_FOUND' | 'INTERNAL_ERROR' | 'INVALID_ARGUMENT' | 'MEDIA_NOT_FOUND' | 'MEDIA_NOT_READY' | 'MEDIA_UPLOAD_FAILED': Why the asset operation failed. Omitted when the status is `SUCCESS`.
    - `message` string, required: Result message for the asset operation.
    - `asset_id` string: Created asset ID when the status is `SUCCESS`. Omitted on failure.
  - `status` 'SUCCESS' | 'PARTIAL_SUCCESS' | 'ERROR', required: Overall outcome of a bulk operation.
  - `success_count` integer, required: Number of successfully created assets.
  - `failure_count` integer, required: Number of assets that failed to create.

## Other responses

- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/media_library/businesses/:business_id/assets/post.md)

---

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