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 username, avatar, nickname (display name), and bio. Changes are submitted as pending and applied manually within 24 hours.
Important Rate Limits (per account):
  • Username: Can only be updated once every 7 days
  • 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 (username, 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
      }
    ]
  }
}