Documentation menu

Create ad identity

A TikTok brand identity from a name and avatar.

POSThttps://app.tryadeli.com/api/v1/ads/identities

AuthorizationBearer <API key>How keys work

Request

curl -X POST "https://app.tryadeli.com/api/v1/ads/identities?accountId=00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ADELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "adAccountId": "7000000000000000001",
  "displayName": "Acme",
  "avatar": {
    "url": "https://cdn.example.com/acme.png"
  }
}'

Response

{
  "platform": "tiktok_ads",
  "accountId": "00000000-0000-0000-0000-000000000000",
  "adAccountId": "7000000000000000001",
  "identity": { "id": "7300000000000000003", "type": "CUSTOMIZED_USER", "displayName": "Acme", "avatarUrl": null }
}

TikTok Ads only. Creates a brand identity from a display name and an avatar image. The avatar is an { "uploadId" } from media uploads (platform tiktok) or an { "url" } TikTok can fetch over HTTPS.

Body

adAccountIdstringRequired: A TikTok advertiser id.
displayNamestringRequired: Shown on the ad, up to 40 characters.
avatarobjectRequired: { uploadId } or { url }: a square image.