Limits & errors
What TikTok Ads through Zernio does not support, and the errors it returns most often.
What you cannot do
TikTok Ads through Zernio does not support:
- Catalog and TikTok Shop ads.
goalhas no catalog option on TikTok, and a catalog campaign built in Ads Manager syncs back asconversions. - TikTok Instant Forms.
goal: "lead_generation"builds a Smart+ lead campaign that sends the click to your own form onlinkUrl. - Spark Ads on an ads-only connection without a Spark Code. The connection has no TikTok identity, so pass
sparkAuthCodeandplatformPostId, or connect the TikTok account itself. - Chunked video upload and async transcode. A video creative transfers in one request, under the 500 MB ceiling in media requirements.
- Creating an ad group on its own.
POST /v1/ads/ad-setsis Google Ads only and answers501everywhere else. - The Meta-only reads and tools. Ad previews, the creative library, reach and frequency, the change log, ad labels, A/B studies, account finance, the image and video libraries and asynchronous insights reports all answer
501on TikTok.
Common errors
| Error | Cause | Fix |
|---|---|---|
422 with code ads_connection_required | No tiktokads account for the profile, or the TikTok user is not authorized as an Identity on the advertiser | Connect TikTok Ads, or authorize the identity in TikTok Ads Manager. |
40002: Please select a pixel | goal: "conversions" without promotedObject.pixelId | Pass the numeric pixel id, or attach to an existing conversion ad group with adSetId. |
40002: pixel_id ... is not a valid integer string | The alphanumeric Pixel Code was sent instead of the numeric id | Use the pixel's id from GET /v1/accounts/{accountId}/tracking-tags (Pixels). |
400 on a boost | countries missing, or callToAction sent without linkUrl | Send targeting.countries, and always pair the CTA with a destination. |
| Budget rejected | Below TikTok's minimum | TikTok's minimum is $20 per ad set. |
A 422 on any ads call means the profile has no TikTok Ads connection:
{
"error": "TikTok Ads is not connected for this profile",
"type": "invalid_request_error",
"code": "ads_connection_required",
"param": "accountId"
}Error handling covers the envelope.
Was this page helpful?