Skip to main content
PATCH
/
v1
/
accounts
/
{accountId}
/
profile
curl -X PATCH https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/profile \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "bio": "Premium fashion content daily 👗✨",
    "profilePictureUrl": "https://example.com/new-pic.jpg"
  }'

{
  "success": true,
  "accountId": "acc_1a2b3c4d5e",
  "platform": "instagram",
  "name": "Fashion Insider",
  "username": "fashioninsider",
  "bio": "Premium fashion content daily 👗✨",
  "profilePictureUrl": "https://storage.googleapis.com/...",
  "updatedAt": "2024-04-21T19:45:00Z"
}

​
Path Parameters

​
accountId
string
required
The unique account identifier.

​
Request Body

​
platform
string
required
Platform to update: tiktok or instagram.
​
name
string
New display name.Restrictions:
  • TikTok: Can change once every 7 days (after Day 5 of warmup)
  • Instagram: Can change once every 14 days
​
username
string
New username. Instagram only - TikTok does not support username changes via this endpoint.Restrictions:
  • Instagram: No restriction on username changes
​
bio
string
New bio/description. No restrictions on frequency.
​
profilePictureUrl
string
URL of new profile picture. Must be a publicly accessible image URL.IMPORTANT: Image must have a 1:1 aspect ratio (square). Non-square images will be rejected.

​
Response

​
success
boolean
Whether the profile was updated successfully.
​
accountId
string
Account identifier.
​
platform
string
Platform: tiktok or instagram.
​
name
string
Updated display name.
​
username
string
Updated username (Instagram only).
​
bio
string
Updated bio.
​
profilePictureUrl
string
Updated profile picture URL.
​
updatedAt
string
ISO 8601 timestamp of when the profile was updated.
​
nextNameChangeAllowed
string
ISO 8601 timestamp of when the name can be changed again (if name was changed).
curl -X PATCH https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/profile \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "bio": "Premium fashion content daily 👗✨",
    "profilePictureUrl": "https://example.com/new-pic.jpg"
  }'

{
  "success": true,
  "accountId": "acc_1a2b3c4d5e",
  "platform": "instagram",
  "name": "Fashion Insider",
  "username": "fashioninsider",
  "bio": "Premium fashion content daily 👗✨",
  "profilePictureUrl": "https://storage.googleapis.com/...",
  "updatedAt": "2024-04-21T19:45:00Z"
}
Name Change RestrictionsAttempting to change the name before the allowed time will return a 429 error with the next allowed change date.

​
Error Responses

Name Change Too Soon
{
  "error": {
    "code": "name_change_restricted",
    "message": "You can change your TikTok name again on 2024-04-28",
    "nextAllowedAt": "2024-04-28T10:00:00Z"
  }
}
Invalid Profile Picture Ratio
{
  "error": {
    "code": "invalid_image_ratio",
    "message": "Profile picture must have a 1:1 aspect ratio (square). Provided image is 1920x1080."
  }
}
Username Not Supported (TikTok)
{
  "error": {
    "code": "invalid_parameter",
    "message": "Username changes are only supported for Instagram accounts"
  }
}