Get Started
Learn how to implement creative asset management.
Creative Asset Management is available to select partners only. Please contact your Meta Partner for more information.
Requirements
To use this API, you need:
Permissions
Upon login to your app, you will need to ask your users for the following permissions:
business_creative_management- Manage business creative folders and business creatives. Required for all Business Creative Asset Manager API endpoints.business_creative_insights- Access business creative asset insights.business_management- Manage business users and accept partnership agreement requests.
Limitations
- The app user (the advertiser) must be an admin of the business represented by the business manager ID
Step 1: Create a Business Creative Folder
Create a business creative folder on behalf of the advertiser's business by making a POST request to the {business-id}/creative_folders endpoint. In this case, {business-id} is the advertiser's business ID.
The business_creative_management permission is required for this action.
Example Request
curl -X POST \
-F 'name={folder-name}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_foldersExample Response
{ “id”: “{business-creative-folder-id}” }You can also create subfolders.
Step 2: Add Creative to Folders
Add existing creative assets to a folder by making a POST request to {business-id}/images or {business-id}/videos. You need business_creative_management permission for this action.
Add Images
Example — To add an image:
curl -X POST \
-F 'bytes={image-content-in-bytes-format}' \
-F 'name={image-name}' \
-F 'access_token={access-token}' \
-F 'creative_folder_id={business-creative-folder-id}' \
https://graph.facebook.com/{version}/{business-id}/imagesResponse
{
"images":{
"{image-name}":{
"id":"{business-image-id}",
"hash":"{hash}",
"url":"{image-url}"
}
}
}Upload Videos
Upload a video in a single request, if it is less than a few megabytes, or upload it in chunks. Make your API call for video upload at graph-video.facebook.com instead of graph.facebook.com.
Example — Send a POST to {business-id}/video and include the name of your video, the source, and the business creative folder ID.
curl -X POST \
-F 'name={video-name}' \
-F 'source='@{video-path}'' \
-F 'access_token={access-token}' \
-F 'creative_folder_id={business-creative-folder-id}' \
https://graph-video.facebook.com/{version}/{business-id}/videosResponse
{
"success": true,
"business_video_id": "{business-video-id}"
}Upload Chunked Videos
For larger videos, send one start request, one or multiple transfer requests, and one finish request.
To make a start request and create a video upload session, send a POST request to /{business-id}/videos, set upload_phase field to start, and specify file_size, in bytes.
curl -X POST \
-F 'title={video-name}' \
-F 'creative_folder_id={business-creative-folder-id}' \
-F 'access_token={access-token}' \
-F 'upload_phase=start' \
-F 'file_size={video_file_size_in_bytes}' \
https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videosSample Response
{
"upload_session_id": "{session-id}",
"business_video_id": "{business-video-id}",
"video_id": "{video-id}",
"start_offset": "0",
"end_offset": "52428800"
}To upload [0, 52428800] from your video, slice the file into chunks according to the start and end offsets, then send those chunks with transfer requests. We send you new offsets for each chunk. Use these new offsets to upload each chunk.
Example: Send your first chunk
curl -X POST \
-F 'title={video-name}' \
-F 'access_token={access-token}' \
-F 'creative_folder_id={business-creative-folder-id}' \
-F 'upload_phase=transfer' \
-F 'upload_session_id={session-id}' \
-F 'start_offset=0' \
-F 'video_file_chunk=@{binary-chunk-filename}' \
https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videosOn success, we respond with the offsets for your next chunk:
{
"start_offset": "52428800", //Start byte position of the next file chunk.
"end_offset": "104857601" //End byte position of the next file chunk.
}Cut and upload the second chunk with the range [52428800, 104857601] from your file and send it:
curl -X POST \
-F 'title={video-name}' \
-F 'access_token={access-token}' \
-F 'creative_folder_id={business-creative-folder-id}' \
-F 'upload_phase=transfer' \
-F 'start_offset=52428801' \
-F 'upload_session_id={your-upload-sesson-id}' \
-F 'video_file_chunk={binary-chunk-filename}' \
https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videosSend all additional chunks until start_offset equals end_offset:
{
"start_offset": "152043520",
"end_offset": "152043520"
}This means you uploaded the whole file. Now you need to post this video and close the upload session.
curl -X POST \
-F 'title={video-name}' \
-F 'access_token={access-token}' \
-F 'creative_folder_id={business-creative-folder-id}' \
-F 'upload_phase=finish' \
-F 'upload_session_id={session-id}' \
https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videosIf you get errors during an upload, you can retry uploading that chunk. Typically errors are due to response issues. Retry your upload for the chunk that failed. For more information about errors, see:
Once you upload creative to a folder, advertisers with access to the folder can create ads either on Ads Manager or with Marketing API.
All uploaded creatives appear in Ads Manager > Media Selection UI. You can use them in Ads Creation and Ads Editing. In addition, the folders and creative assets are available in the Business Manager Media Library tool in Business Manager > Media Library.
Step 3: Provide Deep Link URL to Asset and Create Ad or Post
To get the deep link URL for a specific asset, query the field media_library_url of the uploaded image or video asset:
curl -X GET \
-F 'access_token={partner-access-token}' \
https://graph.facebook.com/v<API_VERSION>/<asset_id>?fields=media_library_urlTo use your deep link to create an ad or a page post, append &action=CREATE_AD or &action=CREATE_POST at the end of the link:
https://business.facebook.com/asset_library/business_creatives/?object_id=<OBJECT_ID>&action=CREATE_AD