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, because TikTok requires a posting account for them. Connect the TikTok account itself, not the ad account alone.
- 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?
Manage Ads
Add ads to an existing TikTok ad group, moderate ad comments, swap creatives, update targeting, duplicate campaigns and list agency Business Centers.
Pinterest Ads
Create Promoted Pin campaigns, promote Pins you already published, upload customer list audiences and read ad metrics on a pinterestads account.