Update a pixel
POST/pixel/update/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/pixel/update/
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 update the Pixel name. Pixel name should correspond with your website/domain name, with length not exceeding 40 characters. Pixel name should not be duplicated.
> Important
> By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms and that you will not share sensitive data with TikTok.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok_business/pixel/update/
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 |
|---|---|---|---|---|---|
| pixel_name | body | string | Yes | Pixel name. Length limit: 40 characters and cannot contain emojis. Note: If you want to keep the name unchanged, set this field to an empty string (""). | |
| pixel_id | body | string | Yes | Pixel ID. | |
| advanced_matching_fields | body | object | No | Manual Advanced Matching settings for the pixel. This setting is only applicable to pixels generated through partner integrations, and does not apply to manually configured pixels. | |
| automatic_advanced_matching_fields | body | object | No | Automatic Advanced Matching settings for the pixel. Automatic Advanced Matching automatically uses customer information collected through your TikTok Pixel, like email, name, and phone number, to improve match rates, conversion tracking, and retargeting. Note: To help protect customer privacy, sensitive information will be hashed before it's shared with TikTok. If you operate within a more regulated or sensitive industry like financial services or health care, consider using Manual Automatic Matching (MAM) instead of Automatic Advanced Matching (AAM). | |
| enable_first_party_cookies | body | boolean | No | Whether to allow first-party cookies.
Allowing first-party cookies will allow the system to share data from your website's first-party cookies with TikTok to improve measurement and help reach more users. Learn more about using cookies with TikTok Pixel.
Supported values: true, false. | |
| enable_expanded_data_sharing | body | boolean | No | Whether to enable expanded data sharing.
Enabling expanded data sharing allows this pixel to collect more information from your website, including page content (such as meta tags, and product details), visitor actions (such as clicks, button interactions, and time spent), and website performance (such as page load speed and responsiveness). This data may be used to improve ad delivery and campaign performance on TikTok. You can view all collected data in TikTok Pixel Helper. Learn more about Expanded Data Sharing with the TikTok Pixel.
Supported values: true, false. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/pixel/update/" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"pixel_name":"","pixel_id":"","advanced_matching_fields":{},"automatic_advanced_matching_fields":{}}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok_business/pixel/update/",
params={},
json={
"pixel_name": "",
"pixel_id": "",
"advanced_matching_fields": {},
"automatic_advanced_matching_fields": {}
},
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/pixel/update/');
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({"pixel_name":"","pixel_id":"","advanced_matching_fields":{},"automatic_advanced_matching_fields":{}}),
});
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/pixel/update/' . '?' . 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, '{"pixel_name":"","pixel_id":"","advanced_matching_fields":{},"automatic_advanced_matching_fields":{}}');
$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, seeAppendix-Return Codes | |
| message | string | Return message, seeAppendix-Return Codes | |
| data | object | Return data. | |
| request_id | string | The log id of a request, which uniquely identifies the request. |
Response sample
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {},
"request_id": "202003181255150101890492232F45E5EA"
}
(/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