List Social Accounts

Overview

The List Social Accounts endpoint allows you to retrieve all social media accounts connected to your OneUp account. This endpoint lists every account, regardless of whether it belongs to a specific category or not.

Base URL:

https://www.oneupapp.io

Endpoint

GET /api/listsocialaccounts?apiKey=YOUR_API_KEY

Example:

GET https://www.oneupapp.io/api/listsocialaccounts?apiKey=621544d93ffe2db52b01

Request Parameters

Parameter	Required	Description
apiKey	Yes	Your personal API key generated from the API Access page.

Sample Request

curl -X GET "https://www.oneupapp.io/api/listsocialaccounts?apiKey=YOUR_API_KEY"

Sample Response

{
  "message": "OK",
  "error": false,
  "data": [
    {
      "username": "SaaS_Growth_Guy",
      "full_name": "SaaS growth tip guy",
      "is_expired": 0,
      "social_network_type": "X",
      "need_refresh": false
    },
    {
      "username": "Davis William",
      "full_name": "Z Davis",
      "is_expired": 0,
      "social_network_type": "Facebook",
      "need_refresh": false
    }
  ]
}

✅ Result: The response returns all the social accounts linked to your OneUp account. Each object includes:

• username — The handle or username of the account.
• full_name — The display name associated with the account.
• is_expired — Indicates whether the account connection has expired (0 = active, 1 = expired).
• social_network_type — The type of social network (e.g., Facebook, X, Pinterest, GBP, etc.).
• need_refresh — Indicates if the account requires reauthorization.

Usage Example

This endpoint is useful when you want to:

1. Retrieve a full list of all connected social media accounts.
2. Identify which accounts may need to be refreshed or reconnected.
3. Use the social_network_type and username to display connected networks in your app dashboard.

✅ Next Step: To view only the accounts linked to a specific category, check the List Category Accounts endpoint.