OverviewProductsPlatformsAPI ReferenceResources

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. goal has no catalog option on TikTok, and a catalog campaign built in Ads Manager syncs back as conversions.
  • TikTok Instant Forms. goal: "lead_generation" builds a Smart+ lead campaign that sends the click to your own form on linkUrl.
  • Spark Ads on an ads-only connection without a Spark Code. The connection has no TikTok identity, so pass sparkAuthCode and platformPostId, 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-sets is Google Ads only and answers 501 everywhere 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 501 on TikTok.

Common errors

ErrorCauseFix
422 with code ads_connection_requiredNo tiktokads account for the profile, or the TikTok user is not authorized as an Identity on the advertiserConnect TikTok Ads, or authorize the identity in TikTok Ads Manager.
40002: Please select a pixelgoal: "conversions" without promotedObject.pixelIdPass the numeric pixel id, or attach to an existing conversion ad group with adSetId.
40002: pixel_id ... is not a valid integer stringThe alphanumeric Pixel Code was sent instead of the numeric idUse the pixel's id from GET /v1/accounts/{accountId}/tracking-tags (Pixels).
400 on a boostcountries missing, or callToAction sent without linkUrlSend targeting.countries, and always pair the CTA with a destination.
Budget rejectedBelow TikTok's minimumTikTok's minimum is $20 per ad set.

A 422 on any ads call means the profile has no TikTok Ads connection:

JSON
{
  "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?

On this page