TagMangoTagMango Docs
Community

List members of a community channel

GET
/api/v1/external/community/channels/{channelId}/members

List the members of one of your community channels — same pagination, name search, and moderator filtering as the dashboard. The channel itself is never excluded from this check — you're always querying one of your own channels, identified by channelId.

You never appear in your own member list — this endpoint always runs as the creator, and a creator is never listed as a member of their own channel, matching the dashboard's own behavior.

Membership here reflects the last time it was recomputed for this channel (adding or removing a subscription/badge triggers an asynchronous recompute, not an instant one) — a member who just gained or lost access may not be reflected immediately.

Fails with a 400 if the Community feature is not enabled for this creator, or a 404 if channelId doesn't belong to you.

External access policy

An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.

These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.

  • Plans: Unrestricted.

  • Tiers: Unrestricted.

AuthorizationBearer <token>

In: header

Path Parameters

channelId*string

Id of the community channel to list members from

Query Parameters

limit?number

Number of members per page.

Range1 <= value <= 100
page?integer

One-based page number. Values below 1 return 400 with "Page number must be greater than or equal to 1".

Range1 <= value
search?string

Case-insensitive search on the member’s name.

moderatorFilter?string

Restrict the results to only moderators, or exclude moderators entirely. Omit to get every member regardless of moderator status.

Value in"only-moderators" | "exclude-moderators"

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/community/channels/61e97c146cf2b4d8c68f3a40/members" \  -H "x-whitelabel-host: string"
{
  "members": [
    {
      "name": "John Doe",
      "profilePicUrl": "https://linktoprofilepic.com/pic.jpg",
      "_id": "string",
      "isModerator": true
    }
  ],
  "totalMembers": 0
}
{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "success": false,
  "message": "Invalid request",
  "result": "Invalid request"
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}
{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}