Skip to main content

POST Generate Affiliate Partner Campaign Product Link

Generate Affiliate Partner Campaign Product Link Asset Required scope: partner.tap_campaign.link.write This API offers the ability to generate campaign product promotion links. Version 202405

POST/affiliate_partner/202405/campaigns/{campaign_id}/products/{product_id}/promotion_link/generate

Request

Path

PropertiesTypeDescription
campaign_id RequiredstringThe ID of the campaign.
product_id RequiredstringThe ID of the product.

Header

PropertiesTypeDescription
content-type RequiredstringAllowed type: application/json
x-tts-access-token RequiredstringThe partner access_token value from Get Access Token, when user_type = 3. Follow this guide to get partner access_token.

Query

PropertiesTypeDescription
app_key RequiredstringEvery single app will have a unique key. Please use the specific key assigned to your app.
sign RequiredstringSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
category_asset_cipher RequiredstringThe partner identifier used in API requests. Retrieve this value by using the [Get Authorized Category Assets API] (https://partner.tiktokshop.com/docv2/page/666012dd609d4402cc3be995).

Body

PropertiesTypeDescription
creator_commission_rate RequiredintThe commission rate paid to a creator in hundredths of a percent (0.01%). The commission rate must be lower than or equal to the total commission rate set by the seller.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintThe success or failure status code returned in API response.
messagestringThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstringRequest log
dataobjectSpecific return information

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 16032001 | nvalid parameter Creator and Seller, please ensure Region mismatch. | | 16032005 | Campaign not found | | 16032007 | Permission denied | | 16032008 | Operation denied | | 16032009 | Product operation denied, please ensure campaign is under online status. | | 16032010 | Campaign product not found | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |

Is this content helpful?Helpful

Not Helpful

PreviousNext