Get X connected accounts

List active X accounts connected to the authenticated Vee3 account.

← All X / Twitter endpoints · Capability overview

GET/v1/x-twitter/connected-accounts

https://api.vee3.io/v1/x-twitter/connected-accounts

0 tokens

List active X accounts connected to the authenticated Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

x-twitter.connected_accounts

Parameters0 fields

Response6 fields

accountsarrayitems

5 fields

Active connected X accounts for the authenticated Vee3 account.

user_idstring

Numeric X user id to pass as user_id on write calls.

user_namestring

X handle without the leading @ to pass as user_name on write calls.

display_namestring

Display name shown on the profile.

avatar_urlstring

Profile avatar image URL.

is_defaultboolean

Whether this account is used when user_id and user_name are omitted on write calls.

HTTP errors: unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/x-twitter/connected-accounts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {

}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses2 examples

200No X accounts connected yet.

no_connected_accounts.json

{
  "accounts": []
}

200Two connected X accounts with one marked default.

two_connected_accounts.json

{
  "accounts": [
    {
      "user_id": "12345",
      "user_name": "vee3io",
      "display_name": "Vee3",
      "avatar_url": "https://pbs.twimg.com/profile_images/example_normal.jpg",
      "is_default": true
    },
    {
      "user_id": "67890",
      "user_name": "vee3dev",
      "display_name": "Vee3 Dev",
      "avatar_url": null,
      "is_default": false
    }
  ]
}