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
| Status | Meaning |
|---|---|
| 200 | Success |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 429 | Too many requests for the key or the account |
| 500 | Something 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
- List posts:
GET /api/v1/posts - Create a post:
POST /api/v1/posts - Get a post:
GET /api/v1/posts/{id} - Cancel a post:
DELETE /api/v1/posts/{id} - Start an image or video upload:
POST /api/v1/media - Get an upload:
GET /api/v1/media/{id} - Delete a video:
DELETE /api/v1/media/{id} - Finish and check a video upload:
POST /api/v1/media/{id}/complete - Write captions:
POST /api/v1/captions - All endpoints
Something wrong or missing? Write to support@wavegrain.com.