Share creative assets
POST/creative/asset/share/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/
Write endpoint — changes data on TikTok Business. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description
Use this endpoint to share existing creative assets under an advertiser account with other advertiser accounts.
To share creative assets, you need to be an Admin or Operator for both the ad account that has the assets and the ad accounts you want to share these assets with. Additionally, you should be the owner of these assets.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 7000000000000000001 | Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| asset_type | body | string | No | Type of creative assets that you want to share.
Enum values: VIDEO, IMAGE, MUSIC
Default value: VIDEO | |
| material_ids | body | string[] | Yes | Material ID. Max size: 20 After successful sharing, the name of the shared creative materials will be copied in the shared advertiser account. Note: Currently, the sharing will only fail when there is a creative material with the same name as the material you want to share under the shared advertiser account. | |
| shared_advertiser_ids | body | string[] | Yes | IDs of advertisers that you want to share creative materials with. Max size: 10. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"material_ids":[],"shared_advertiser_ids":[]}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/",
params={},
json={
"material_ids": [],
"shared_advertiser_ids": []
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"material_ids":[],"shared_advertiser_ids":[]}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/creative/asset/share/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"material_ids":[],"shared_advertiser_ids":[]}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;Response
Response fields (as returned by TikTok Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| code | number | Return code, see Appendix-Return Codes. | |
| message | string | Return message, see Appendix-Return Codes. | |
| data | object | Returned data. | |
| failed_infos | map | Information about the failed sharing. Note: Currently, the sharing will only fail when there is a creative material with the same name as the material you want to share under the shared advertiser account. | |
| key | string | Advertiser ID that you fail to share creative materials with. | |
| value | string[] | Material IDs that you fail to share. | |
| request_id | string | The log id of the request, which uniquely identifies a request. |
Response sample
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"failed_infos": {
"×××××××××××××××": [
"×××××××××××××××",
"×××××××××××××××"
],
"×××××××××××××××": [
"×××××××××××××××",
"×××××××××××××××"
]
}
}
}
(/code);
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above