List brands, groups and connected accounts

List brands, groups and connected accounts with the Wavegrain Posting API: GET /api/v1/accounts. Responses and an example request.

GET /api/v1/accounts is part of the Posting API. Every call needs an access key: see Authentication.

Needs the read permission.

Every connected account with its network, groups, posts in the last 24 hours, the network's daily limit and how many posts it may still send today. networks says what each network can do on Wavegrain now, for example TikTok posting as Only me before its audit.

Example request

curl https://wavegrain.com/api/v1/accounts \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"

Responses

StatusMeaning
200Success
401No access key, or an unknown, revoked or expired one
403The key lacks the permission, or the account has no active plan
429Too many requests for the key or the account
500Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing.

A successful answer:

{
  "brands": [
    {
      "id": "brd_K3m9",
      "name": "Koi Kitchen",
      "timeZone": "Europe/Berlin",
      "groups": [
        {
          "id": "grp_7Qa1",
          "name": "Main",
          "isDefault": true,
          "notes": "",
          "avoid": [],
          "accountIds": [
            "acc_4Ft7Wz"
          ]
        }
      ]
    }
  ],
  "accounts": [
    {
      "id": "acc_4Ft7Wz",
      "network": "instagram",
      "name": "Koi Kitchen",
      "status": "connected",
      "reconnectBy": null,
      "groupIds": [
        "grp_7Qa1"
      ],
      "postsLast24h": 2,
      "dailyLimit": 50,
      "leftToday": 48,
      "capReached": null
    }
  ],
  "networks": [
    {
      "network": "instagram",
      "name": "Instagram",
      "state": "ready",
      "note": null,
      "autoPost": true,
      "needsOptIn": false
    }
  ]
}

More in the Posting API

Something wrong or missing? Write to support@wavegrain.com.