Troubleshoot Accounts

curl -X POST https://api.ugc.inc/accounts/troubleshoot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

response = requests.post(
    'https://api.ugc.inc/accounts/troubleshoot',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={}
)

data = response.json()

if data['ok']:
    unhealthy = [a for a in data['data'] if not a['healthy']]
    print(f'{len(unhealthy)} accounts have issues')
    for account in unhealthy:
        print(f"  {account['username']}: {account['fail_reason']}")

const response = await fetch('https://api.ugc.inc/accounts/troubleshoot', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
});

const data = await response.json();

if (data.ok) {
  const unhealthy = data.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Check all active accounts
const response = await client.accounts.troubleshoot();

// Check specific accounts
const response2 = await client.accounts.troubleshoot({
  accountIds: ['acc_123', 'acc_456']
});

if (response.ok) {
  const unhealthy = response.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "acc_123456",
      "username": "fitness_guru",
      "type": "tiktok",
      "status": "warmed",
      "tag": "premium",
      "healthy": true,
      "fail_reason": null,
      "failed_tasks": 2,
      "total_tasks": 50
    },
    {
      "id": "acc_789012",
      "username": "cooking_tips",
      "type": "tiktok",
      "status": "warming",
      "tag": null,
      "healthy": false,
      "fail_reason": "proxy_issue",
      "failed_tasks": 15,
      "total_tasks": 20
    }
  ]
}

Endpoint

POST https://api.ugc.inc/accounts/troubleshoot

Overview

Run diagnostics on your active accounts to identify health issues. Returns a healthy boolean and a fail_reason enum for each account that has a problem. Only accounts with status setup, warming, or warmed are included. This endpoint checks proxy connectivity and task success rates to determine account health.

Fail Reasons

Value	Description
`proxy_issue`	The account’s proxy is either missing or failing connectivity checks. This means the account’s device cannot route traffic properly, which will cause warmup tasks and posts to fail.

Request Body

string[]

Optional array of account IDs to check. If omitted, all active accounts are checked.

Response

TroubleshootAccount[]

Array of account health results

Show TroubleshootAccount properties

string

Account ID

string | null

Account username

string

Platform type (tiktok or instagram)

string

Account status (setup, warming, or warmed)

string | null

Account tag

boolean

Whether the account is healthy. false if any issues were detected.

string | null

The reason the account is unhealthy. null if the account is healthy. See the Fail Reasons table above for possible values.

number

Total number of failed tasks for this account

number

Total number of tasks for this account

curl -X POST https://api.ugc.inc/accounts/troubleshoot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

response = requests.post(
    'https://api.ugc.inc/accounts/troubleshoot',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={}
)

data = response.json()

if data['ok']:
    unhealthy = [a for a in data['data'] if not a['healthy']]
    print(f'{len(unhealthy)} accounts have issues')
    for account in unhealthy:
        print(f"  {account['username']}: {account['fail_reason']}")

const response = await fetch('https://api.ugc.inc/accounts/troubleshoot', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
});

const data = await response.json();

if (data.ok) {
  const unhealthy = data.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Check all active accounts
const response = await client.accounts.troubleshoot();

// Check specific accounts
const response2 = await client.accounts.troubleshoot({
  accountIds: ['acc_123', 'acc_456']
});

if (response.ok) {
  const unhealthy = response.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "acc_123456",
      "username": "fitness_guru",
      "type": "tiktok",
      "status": "warmed",
      "tag": "premium",
      "healthy": true,
      "fail_reason": null,
      "failed_tasks": 2,
      "total_tasks": 50
    },
    {
      "id": "acc_789012",
      "username": "cooking_tips",
      "type": "tiktok",
      "status": "warming",
      "tag": null,
      "healthy": false,
      "fail_reason": "proxy_issue",
      "failed_tasks": 15,
      "total_tasks": 20
    }
  ]
}

Getting Started

Data Structures

Posts

Comments

Accounts

Statistics

Tasks

Organization

Media

Billing

Automations

Endpoint

Overview

Fail Reasons

Request Body

Response

​Endpoint

​Overview

​Fail Reasons

​Request Body

​Response

Endpoint

Overview

Fail Reasons

Request Body

Response