Update Target Collaboration

This API is used by Seller to update STANDARD target collaboration.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• The Shop Ads commission you configured in open collaboration, or
• The standard commission defined in this invitation. The commission rate is specified in increments of 1/10,000. For example, 1000 stands for 0.1 or 10%. | creator_user_open_ids |[]string |Y |["123123213213"] |The list of Creators' TikTok User Open IDs invited in the target collaboration. The maximum number of creators is 50. More details | seller_contact_info |object |Y | |Contact information for the seller in the target collaboration. | ^email |string |Y |test@bytedance.com |Seller's email contact information | ^phone_number |string |N |1234567890 |The phone number of the seller. | ^whatsapp |string |N |1234567890 |The phone number used by the seller to register for WhatsApp. | ^telegram |string |N |1234567890 |The seller's Telegram username or phone number. | ^line |string |N |1234567890 |The phone number used by the seller to register for the Line app | free_sample_rule |object |Y | |The free sample rules set by the seller in the target collaboration. | ^has_free_sample |bool |Y |true |If true, free samples are provided to creators invited to the target collaboration. | ^is_sample_approval_exempt |bool |Y |true |If true, creators invited to the target collaboration are exempt from seller review and will automatically be approved for a free sample. Note that if has_free_sample=false, this field will not take effect. |

Query

https://open-api.tiktokglobalshop.com/affiliate_seller/202508/target_collaborations/7890786712312312?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"name":"openapi_test","end_time":"1715654330","products":[{"id":"789078671231312312","commission_rate":1000,"target_ad_commission_rate":1000}],"creator_user_open_ids":["123123213213"],"seller_contact_info":{"email":"test@bytedance.com","phone_number":"1234567890","whatsapp":"1234567890","telegram":"1234567890","line":"1234567890"},"free_sample_rule":{"has_free_sample":true,"is_sample_approval_exempt":true}}

{"code":0,"data":{"target_collaboration_conflicts":[{"creator_user_open_id":"7494656937121841111","product_id":"789078671231"}],"update_failed":{"remove_creator_open_ids":["12345"],"remove_product_ids":["12345"],"add_creator_open_ids":["12345"],"add_products":{"id":"789078671231312312","commission_rate":1000},"change_commissions":{"product_id":"789078671231312312","commission_rate":1000},"end_time":1715654330,"seller_contact_info":{"email":"test@bytedance.com","phone_number":"(+62) 1234567890\n","whatsapp":"(+62) 1234567890\n","telegram":"(+62) 1234567890\n","line":"(+62) 1234567890\n"},"name":"openapi_test","invalid_product_id_list":["1234"],"invalid_open_id_list":["xxxxxx"]}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code