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
array
required
Array of account updates to apply. Each update object contains:
Show Update object properties
Show Update object properties
string
required
Account ID to update
string
New tag value for categorization
string
New organization group identifier
string
New user group identifier
string
Comma-separated list of keywords for warmup activities (e.g., “fitness,health,workout”)
string
Comma-separated list of profile usernames for warmup activities (e.g., “@fitinfluencer1,@healthguru2”)
string
Description/interest area for the account. Used by v1_smart warmup for browse tasks (e.g., “health and wellness content”)
'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)'original' | 'v1_custom' | 'manual_posting'
Post flow version.
'original' uses standard posting flow, 'v1_custom' uses customized posting flow, 'manual_posting' skips automated postingboolean
Whether the account follows recommended best practices. Set to
false to flag accounts with user-overridden guidelines.Each update in the array must include at least one field to update (tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion, or approved).
Response
object
Response object containing success summary and results
Show Response properties
Show Response properties
string
Summary message indicating how many accounts were updated
number
Number of accounts successfully updated
number
Number of accounts that failed to update
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"
}
]
}'
import requests
response = requests.post(
'https://api.ugc.inc/accounts/update-info',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={
'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'
}
]
}
)
data = response.json()
if data['ok']:
print(f"Updated {data['data']['successful']} account(s)")
if data['data']['failed'] > 0:
for result in data['data']['results']:
if not result['success']:
print(f"Failed: {result['accountId']} - {result['error']}")
const response = await fetch('https://api.ugc.inc/accounts/update-info', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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'
}
]
})
});
const data = await response.json();
if (data.ok) {
console.log(`Updated ${data.data.successful} account(s)`);
if (data.data.failed > 0) {
data.data.results.filter(r => !r.success).forEach(r => {
console.log(`Failed: ${r.accountId} - ${r.error}`);
});
}
}
import { UGCClient } from 'ugcinc';
const client = new UGCClient({
apiKey: 'YOUR_API_KEY'
});
const response = await client.accounts.updateInfo({
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'
}
]
});
if (response.ok) {
console.log(`Updated ${response.data.successful} account(s)`);
response.data.results.forEach(result => {
if (result.success) {
console.log(`Account ${result.accountId}: tag = ${result.account?.tag}`);
} else {
console.log(`Account ${result.accountId} failed: ${result.error}`);
}
});
}
{
"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"
}
}
]
}
}
{
"ok": true,
"code": 200,
"message": "Updated 1 account(s), 1 failed",
"data": {
"message": "Updated 1 account(s), 1 failed",
"successful": 1,
"failed": 1,
"results": [
{
"accountId": "acc_123456",
"success": true,
"account": {
"id": "acc_123456",
"type": "tiktok",
"tag": "premium"
}
},
{
"accountId": "acc_invalid",
"success": false,
"error": "Account not found"
}
]
}
}