Set TikTok brand identity
Set or update the Brand Identity (display name + avatar) for a
tiktokads SocialAccount. TikTok requires every ad to carry an
identity_id + identity_type pair. The Brand Identity is the
CUSTOMIZED_USER alternative to attributing ads to a real @username
(TT_USER). This route uploads the supplied image to TikTok, creates
the identity via /v2/identity/create/, and caches the resulting
identity_id on the account so subsequent POST /v1/ads/create
calls can opt into it via identityType: 'CUSTOMIZED_USER'.
Configurable on every tiktokads account, including linked-mode ones
(those with a posting account on the same profile). Configuration is
idempotent and harmless when posting is also connected: the default
ad-create path still prefers TT_USER, and CUSTOMIZED_USER is only used
per-ad when the caller explicitly opts in.
TikTok identities are immutable post-creation. Re-saving creates a new identity on TikTok and swaps the cached id; the old identity stays orphaned on TikTok's side (harmless, no billing impact).
Alternative: pass brandIdentity directly on POST /v1/ads/create to
configure on first ad creation in a single round-trip.
API key authentication - use your Zernio API key as a Bearer token
In: header
SocialAccount ID of the tiktokads account.
Brand name shown above the ad on TikTok.
1 <= length <= 40Public URL of a square brand image (≥98×98 px, JPG/PNG, max 5 MB). Used as the brand avatar on the ad.
uriResponse Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.connect.configureTikTokAdsBrandIdentity({ body: { accountId: 'account_abc123', displayName: 'Example', imageUrl: 'https://example.com', },});console.log(data);{
"success": true,
"identityId": "string",
"displayName": "string"
}{
"error": "Unauthorized"
}Select Snapchat profile POST
Complete the Snapchat connection flow by saving the selected Public Profile. Snapchat requires a Public Profile to publish content. Use X-Connect-Token if connecting via API key.
Connect WhatsApp via credentials POST
Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow. To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number)