Account Management

This section documents the endpoints available for managing connected social media accounts.

Base URL

https://api.multi-upload-tool.com/api/v1

Authentication

All requests require an API Token in the header: x-api-key: YOUR_API_TOKEN

List Connected Accounts

Retrieve a list of all social media accounts connected to your profile.

Response fields: id, platform, accountName, profileImageUrl, status, tags.

Endpoint

GET /accounts

Query Parameters

Example Request

curl -X GET "https://api.multi-upload-tool.com/api/v1/accounts?platform=tiktok" \
  -H "x-api-key: YOUR_API_TOKEN"

Example Response

{
  "success": true,
  "data": [
    {
      "id": 123,
      "platform": "tiktok",
      "accountName": "my_tiktok_user",
      "profileImageUrl": "https://...",
      "status": "active",
      "tags": "personal,marketing"
    }
  ],
  "count": 1
}

Get Account Details

Retrieve details for a specific connected account.

Endpoint

GET /accounts/:id

Response fields: id, platform, accountName, profileImageUrl, status, connectedAt, tags, failureCount, lastUsedAt.

Example Response

{
  "success": true,
  "data": {
    "id": 123,
    "platform": "tiktok",
    "accountName": "my_tiktok_user",
    "profileImageUrl": "https://...",
    "status": "active",
    "connectedAt": "2023-01-01T12:00:00.000Z",
    "tags": "personal,marketing",
    "failureCount": 0,
    "lastUsedAt": "2023-01-02T08:00:00.000Z"
  }
}

LinkedIn Pages

Retrieve LinkedIn Pages/Organizations available for the user. Optionally scope to a specific connected account.

Endpoint

GET /accounts/linkedin/pages

Query Parameters

Example Response

{
  "success": true,
  "pages": [
    {
      "id": "urn:li:organization:123",
      "name": "My Company"
    }
  ]
}

Delete Account

Disconnect a social media account.

Endpoint

DELETE /accounts/:id

Example Response

{
  "success": true,
  "message": "Account disconnected",
  "data": {
    "id": 123,
    "platform": "tiktok",
    "accountName": "my_tiktok_user"
  }
}