Skip to content

Adds many users to a space in one call, either from an explicit id list or by copying the membership of another space or course in batches.

Send up to 500 ids in user_ids; larger payloads are rejected with a 413 so the client must chunk them. With no ids the request is treated as a source-copy batch and the response reports added, skipped and failed counts so the client can resume from the returned offset. role accepts member, moderator or admin.

Endpoint

  • Method: POST

  • Path: /spaces/{spaceSlug}/members/bulk-add

  • Edition: PRO

  • Controller: BulkMembersController@bulkAddMembers

  • Route source: fluent-community-pro/app/Http/Routes/api.php:121

  • Controller source: fluent-community-pro/app/Http/Controllers/BulkMembersController.php

  • Requires the can_add_member permission in this space.

  • Requires FluentCommunity Pro.

Live sample

The request and response below were recorded against a running FluentCommunity install and then anonymised — member names, emails, avatars and post content are fictional, and long collections are trimmed to a few entries.

POST Post Bulk Add Members

POST
/spaces/{spaceSlug}/members/bulk-add

Adds many users to a space in one call, either from an explicit id list or by copying the membership of another space or course in batches.

Controller: BulkMembersController@bulkAddMembers
Route source: fluent-community-pro/app/Http/Routes/api.php:121

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Parameters

Path Parameters

spaceSlug*

SpaceSlug extracted from the URL path.

Type
string
Required

Request Body

application/json
JSON
{
  
"role": "string",
  
"user_ids": [
  
  
"string"
  
]
}

Responses

Successful response

application/json
JSON
{
  
"added": 0,
  
"failed": 0,
  
"has_more": true,
  
"message": "string",
  
"processed": 0,
  
"skipped": 0,
  
"total": 0
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation