Skip to main content

​
Endpoint

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

​
Overview

Update the social media profile of an account including avatar, nickname (display name), and bio. This endpoint creates a task that will update the actual TikTok/Instagram profile.
Important Rate Limits:
  • Nickname: Can only be updated once every 7 days
  • Avatar: Can only be updated once every 24 hours
  • Bio: Can only be updated once every 24 hours
If you attempt to update a field before its cooldown period has elapsed, you’ll receive an error with details about when the next update is allowed.
Avatar Image Requirements:
  • Aspect Ratio: Avatar images must have a 1:1 aspect ratio (square images)
  • Minimum Dimensions: At least 250x250 pixels
  • Supported Formats: JPEG, PNG, WebP
  • Accessibility: URL must be publicly accessible
If the image does not meet these requirements, the request will be rejected with an error showing the actual dimensions.

​
Request Body

​
accountId
string
required
Account ID to update
​
avatarUrl
string
New avatar/profile picture URL (must be publicly accessible, have a 1:1 aspect ratio, and be at least 250x250 pixels)
​
nickName
string
New display name (max 30 characters)
​
bio
string
New bio text (max 80 characters for TikTok, 150 for Instagram)
At least one of avatarUrl, nickName, or bio must be provided.

​
Response

​
data
object
curl -X POST https://api.ugc.inc/accounts/update-social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_123456",
    "nickName": "Cool Creator ✨",
    "bio": "Content creator 🎥 | Follow for daily tips",
    "avatarUrl": "https://storage.example.com/new-avatar.jpg"
  }'

{
  "ok": true,
  "code": 200,
  "message": "Profile update task created successfully",
  "data": {
    "message": "Profile update task created successfully"
  }
}