Skip to main content
GET
/
api
/
partner
/
v1
/
accounts
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/accounts \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Accounts retrieved",
  "data": {
    "scope": "workspace",
    "owner_user_id": "7be83ba4-14e5-47ba-a662-0ad42d852111",
    "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
    "accounts": [
      {
        "id": "6b0c8c9c-55ac-4fcb-85ec-70b5a8b0d089",
        "platform": "instagram",
        "type": "byo",
        "username": "brandhq",
        "display_name": "Brand HQ",
        "status": "active",
        "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac"
      },
      {
        "id": "0f4f54d4-8cce-4fb7-8c7b-befbcb8af812",
        "platform": "tiktok",
        "type": "hosted",
        "username": "ugc_trends_42",
        "display_name": "Hosted Trends 42",
        "status": "active",
        "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac"
      }
    ]
  }
}
List the TikTok, Instagram, YouTube, Pinterest, LinkedIn, and Facebook accounts available in the authenticated key scope - including both your own connected accounts (BYO) and hosted creator accounts. Use this endpoint to discover the account_id you need when calling Create Post.

Behavior

  • The API merges active BYO social accounts with active hosted accounts in scope.
  • Workspace keys return workspace accounts. Personal keys return personal accounts (user_id = owner_user_id, workspace_id IS NULL).
  • IDs are stable UUIDs constrained to key scope. If no active accounts exist, the endpoint returns an empty array.
  • Each account is normalized to expose the platform (tiktok, instagram, etc.) and a simplified type of byo or hosted.

Response

scope
string
Authenticated key scope: workspace or personal.
owner_user_id
string
Resolved owner user ID for the authenticated key.
workspace_id
string | null
Workspace ID for workspace keys, otherwise null.
accounts
array
List of social accounts available for posting.
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/accounts \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Accounts retrieved",
  "data": {
    "scope": "workspace",
    "owner_user_id": "7be83ba4-14e5-47ba-a662-0ad42d852111",
    "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
    "accounts": [
      {
        "id": "6b0c8c9c-55ac-4fcb-85ec-70b5a8b0d089",
        "platform": "instagram",
        "type": "byo",
        "username": "brandhq",
        "display_name": "Brand HQ",
        "status": "active",
        "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac"
      },
      {
        "id": "0f4f54d4-8cce-4fb7-8c7b-befbcb8af812",
        "platform": "tiktok",
        "type": "hosted",
        "username": "ugc_trends_42",
        "display_name": "Hosted Trends 42",
        "status": "active",
        "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac"
      }
    ]
  }
}

Error Responses

  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 accounts_failed - Database query failed unexpectedly