Skip to main content

​
Endpoint

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

​
Overview

Update the social media profile of one or more accounts including avatar, nickname (display name), and bio. This endpoint creates tasks that will update the actual TikTok/Instagram profiles.
Important Rate Limits (per account):
  • 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, that account update will fail 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

​
updates
array
required
Array of account social profile updates to apply. Each update object contains:
Each update in the array should include at least one field to update (avatarUrl, nickName, or bio).

​
Response

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

{
  "ok": true,
  "code": 200,
  "message": "Created profile update tasks for 2 account(s)",
  "data": {
    "message": "Created profile update tasks for 2 account(s)",
    "successful": 2,
    "failed": 0,
    "results": [
      {
        "accountId": "acc_123456",
        "success": true
      },
      {
        "accountId": "acc_789012",
        "success": true
      }
    ]
  }
}