Add moderators to a community

Give accounts the moderator role in a community, or add them as moderators, from your own systems.

Moderators are the community's admins: they approve join requests, review posts, manage groups, and add other moderators. This endpoint does what Manage > Users > Make admin does in Brand Control Center. The account behind your access token has to be the community's leader or a moderator already; your brand's owner account is a moderator of every community created under the brand. See Generate an access token for the token.

Endpoint

POST /api/thirdparty/community/add_moderators

Environment	Base URL
Production	https://api.begenuin.com
QA	https://api.qa.begenuin.com

Send the token as a bearer token in the Authorization header, and the fields as a JSON body with the Content-Type: application/json header.

Parameters

Parameter	Type	Required	Description
community_id	string	Required	UUID of the community.
users	array	Required	Who to make moderators, each {"user_id": "<uuid>"} or {"phone_number": "<digits>"}. At least one entry has to be valid; invalid entries are ignored.

user_id is the UUID of an existing account; accounts that are active or pending qualify. phone_number is digits only with the country code first, such as 14155552671; a number without an account gets a pending account that the person takes over when they sign up.

Returns

Returns 200 OK with the member objects that were made moderators. A listed account that was already a member is promoted; one that wasn't a member is added with the moderator role. The leader and existing moderators are left as they are. Pending accounts are added with an inactive status and become active on signup.

Request

cURL

bash

curl -X POST https://api.begenuin.com/api/thirdparty/community/add_moderators \
  -H "Authorization: Bearer {{GN_ACCESS_TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "community_id": "{{COMMUNITY_ID}}",
    "users": [{ "user_id": "{{USER_ID}}" }]
  }'

Response

json

{
  "code": 200,
  "message": "XXXX-[Members Added]",
  "data": {
    "moderators_added": [
      {
        "member_id": "8bf08f1f-9fb6-445b-85b4-156f19f6ae8b",
        "name": "Avery Chen",
        "bio": null,
        "nickname": "averyc",
        "is_brand_system_user": false,
        "is_avatar": true,
        "profile_image": "dog_face",
        "profile_image_s": "",
        "profile_image_m": "",
        "profile_image_l": "",
        "role": 3
      }
    ]
  }
}

role is 3, the moderator role; 1 is the leader and 2 a member. moderators_added lists only the accounts whose role changed in this call.

Errors

Every error response carries an HTTP status, a string code, a message, and a data object. Match on code.

HTTP status	code	Cause	Fix
412 Precondition Failed	5166	community_id isn't a UUID, users is empty or has no valid entry, or the token's account isn't the leader or a moderator of the community. Message: XXXX-[Invalid Use of API].	Check the ids, and call from an account with the moderator role.
404 Not Found	5218	The community doesn't exist or is deleted. Message: The community you are looking for is no longer available.	Check the UUID.
400 Bad Request	1099	The server couldn't process the request.	Retry once. If it persists, contact the Genuin team with the request timestamp.

Limitations

One community per call: Loop over communities to add the same moderator to several.
No demotion: There's no third-party endpoint to remove the moderator role. Change roles in Brand Control Center under Manage > Users.
Rate limit: There's no rate limit on this endpoint.