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 for one or more accounts. This endpoint updates the internal categorization and grouping of accounts without modifying the social media profile itself.

​
Request Body

​
updates
array
required
Array of account updates to apply. Each update object contains:
Each update in the array must include at least one field to update (tag, org_group, user_group, keywords, profiles, description, warmupVersion, or postVersion).

​
Response

​
data
object
Response object containing success summary and results
curl -X POST https://api.ugc.inc/accounts/update-info \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {
        "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"
      },
      {
        "accountId": "acc_789012",
        "tag": "standard",
        "warmupVersion": "original"
      }
    ]
  }'

{
  "ok": true,
  "code": 200,
  "message": "Updated 2 account(s)",
  "data": {
    "message": "Updated 2 account(s)",
    "successful": 2,
    "failed": 0,
    "results": [
      {
        "accountId": "acc_123456",
        "success": true,
        "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"
        }
      },
      {
        "accountId": "acc_789012",
        "success": true,
        "account": {
          "id": "acc_789012",
          "type": "tiktok",
          "tag": "standard",
          "warmup_version": "original",
          "username": "anothercreator",
          "nick_name": "Another Creator"
        }
      }
    ]
  }
}