Get Accounts

Retrieves all platform accounts connected to a specific user. This tool allows you to get information about all the social media and content platform accounts a user has authorized your application to access.

This tool is part of the Account Tools category.

Parameters

Name	Type	Required	Description
user_id	string	Yes	The ID of the user to get accounts for

Example Request

{
  "user_id": "user_12345"
}

Example Response

[
  {
    "id": "acc_12345678",
    "user_platform": "YOUTUBE",
    "platform_account_id": "channel_xyz123",
    "username": "ExampleChannel",
    "joined_at": "2020-01-15T00:00:00.000Z",
    "url": "https://youtube.com/channel/channel_xyz123",
    "category": "Entertainment",
    "verified": true,
    "created_at": "2023-05-20T15:30:00.000Z",
    "updated_at": "2023-06-10T09:45:00.000Z",
    "last_refreshed_at": "2023-06-10T09:45:00.000Z"
  },
  {
    "id": "acc_87654321",
    "user_platform": "INSTAGRAM",
    "platform_account_id": "insta_user_789",
    "username": "exampleuser",
    "joined_at": "2019-03-22T00:00:00.000Z",
    "url": "https://instagram.com/exampleuser",
    "category": "Personal",
    "verified": false,
    "created_at": "2023-05-21T10:15:00.000Z",
    "updated_at": "2023-06-11T14:30:00.000Z",
    "last_refreshed_at": "2023-06-11T14:30:00.000Z"
  }
]

Usage Notes

• This method returns all accounts for a single user across all platforms.
• The response is an array of account objects, each containing platform-specific details.
• If the user has no connected accounts, an empty array will be returned.
• Use Refresh Accounts to update the account data from the platforms.
• For fresh data, consider using Fetch Account to get real-time information directly from the platforms.

Related Tools

• Get Account - Fetch a specific account by ID
• Create Account - Create a new platform account
• Refresh Accounts - Refresh account data from platforms
• User Accounts - Alternative way to get user accounts