Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/update-info

​
Overview

Update account metadata including tag, organization group, user group, keywords, profiles, description, and warmup version. This endpoint updates the internal categorization and grouping of accounts without modifying the social media profile itself.

​
Request Body

​
accountId
string
required
Account ID to update
​
tag
string
New tag value for categorization
​
org_group
string
New organization group identifier
​
user_group
string
New user group identifier
​
keywords
string
Comma-separated list of keywords for warmup activities (e.g., “fitness,health,workout”)
​
profiles
string
Comma-separated list of profile usernames for warmup activities (e.g., “@fitinfluencer1,@healthguru2”)
​
description
string
Description/interest area for the account. Used by v1_smart warmup for browse tasks (e.g., “health and wellness content”)
​
warmupVersion
'original' | 'v1_smart'
Warmup scheduling algorithm version. 'original' uses standard scheduling (20-30 min durations), 'v1_smart' uses optimized algorithm with custom flows (5-10 min after day 4)
At least one of tag, org_group, user_group, keywords, profiles, description, or warmupVersion must be provided.

​
Response

​
data
object
Response object containing success message and updated account
curl -X POST https://api.ugc.inc/accounts/update-info \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_123456",
    "tag": "premium",
    "org_group": "marketing",
    "user_group": "team_alpha",
    "keywords": "fitness,health,workout",
    "profiles": "@fitinfluencer1,@healthguru2",
    "description": "health and wellness content",
    "warmupVersion": "v1_smart"
  }'

{
  "ok": true,
  "code": 200,
  "message": "Account info updated successfully",
  "data": {
    "message": "Account info updated successfully",
    "account": {
      "id": "acc_123456",
      "type": "tiktok",
      "tag": "premium",
      "org_group": "marketing",
      "user_group": "team_alpha",
      "keywords": "fitness,health,workout",
      "profiles": "@fitinfluencer1,@healthguru2",
      "description": "health and wellness content",
      "warmup_version": "v1_smart",
      "username": "coolcreator",
      "nick_name": "Cool Creator",
      "pfp_url": "https://storage.example.com/avatar.jpg"
    }
  }
}