Skip to main content
GET
/
api
/
v1
/
accounts
Connected Accounts
curl --request GET \
  --url https://app.nouvel.ai/api/v1/accounts \
  --header 'Authorization: <authorization>'
{
  "accounts": [
    {
      "id": "<string>",
      "platform": "<string>",
      "username": "<string>",
      "displayName": "<string>",
      "avatarUrl": "<string>",
      "followersCount": 123
    }
  ]
}
List all social media accounts connected to your organization. Use this to discover available accounts for publishing or to display account information in your integration.

​
Authentication

​
Authorization
string
required
Your Nouvel API key with analytics:read permission. Format: Bearer nvl_xxxx

​
Query Parameters

​
platform
string
Filter accounts by platform. Supported values: instagram, tiktok, youtube, facebook, linkedin, pinterest, threads, twitter, reddit

​
Response

​
accounts
array
required
List of connected social media accounts.

​
Example Requests

curl https://app.nouvel.ai/api/v1/accounts \
  -H "Authorization: Bearer nvl_xxxx"

​
Response Examples

{
  "accounts": [
    {
      "id": "6612f1a2b3c4d5e6f7890123",
      "platform": "instagram",
      "username": "mybrand",
      "displayName": "My Brand",
      "avatarUrl": "https://scontent.cdninstagram.com/...",
      "followersCount": 15000
    },
    {
      "id": "6612f1a2b3c4d5e6f7890456",
      "platform": "tiktok",
      "username": "mybrand_official",
      "displayName": "My Brand Official",
      "avatarUrl": "https://p16-sign.tiktokcdn.com/...",
      "followersCount": 42000
    }
  ]
}

​
Error Codes

CodeDescription
401Invalid or missing API key
402Plan doesn’t include API access
403API key missing analytics:read permission
404No organization found for the user

​
Notes

  • Accounts are connected via the Nouvel dashboard (Settings > Connected Accounts)
  • Account data is synced from the social platform — follower counts may lag by up to 1 hour
  • The id field is the identifier you’ll use as accountId when calling the Publish endpoint