Documentation menu

List ad identities

The brand identities a TikTok ad can run as.

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

AuthorizationBearer <API key>How keys work

Request

curl "https://app.tryadeli.com/api/v1/ads/identities?accountId=00000000-0000-0000-0000-000000000000&adAccountId=7000000000000000001" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

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

TikTok Ads only. The brand identities a TikTok ad can run as on this ad account: a display name and avatar shown on the ad, rather than a TikTok account. Pass an id as identity.identityId when creating a campaign.

Query parameters

adAccountIdstringRequired: A TikTok advertiser id.