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": "Workspace accounts retrieved",
  "data": {
    "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 accounts (BYO + hosted) that the workspace can post to. Use this endpoint to discover the account_id you need when calling the Create Post endpoint.

​
Behavior

  • The API merges the workspace’s active BYO social accounts with any active hosted accounts. Only active accounts are returned.
  • IDs are stable UUIDs scoped to the workspace. If a workspace has no active accounts 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

​
workspace_id
string
The ID of the workspace associated with the API key.
​
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": "Workspace accounts retrieved",
  "data": {
    "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/403 — authentication failed or token lacks access to the workspace
  • 500 accounts_failed — Database query failed unexpectedly