Lexicon Garden

chat.bsky.group.createGroup

Creates a group convo, specifying the members to be added to it. Unlike getConvoForMembers, this isn't idempotent. It will create new groups even if the membership is identical to pre-existing groups. Will create 'request' membership for all members, except the owner who is 'accepted'.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority
Details · procedure
Kindprocedure
Authoritygroup.bsky.chat
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

members

requiredarray

The members to add to the group. The owner is automatically added. Implementations may enforce a lower maximum than the 10,000-item schema limit; Bluesky currently supports up to 100 total members. If the owner is included in this list, the list may contain up to the implementation's total member limit. Otherwise, it may contain one fewer.

  • maxLength: 10000
itemsstring · did

name

requiredstring
  • minLength: 1
  • maxLength: 500
  • maxGraphemes: 50

Output

application/json

convo

requiredref
Reference

Errors

AccountSuspended

No description in schema.

BlockedActor

No description in schema.

BlockedSubject

No description in schema.

NewAccountCannotCreateGroup

No description in schema.

NotFollowedBySender

No description in schema.

RecipientNotFound

No description in schema.

UserForbidsGroups

No description in schema.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • chat.bsky.group.addMembers

    procedure

    Adds members to a group. The members are added in 'request' status, so they have to accept it. This creates convo memberships.

  • chat.bsky.group.approveJoinRequest

    procedure

    Approves a request to join a group (via join link) the user owns. Action taken by the group owner.

  • chat.bsky.group.requestJoin

    procedure

    Sends a request to join a group (via join link) to the group owner. Action taken by the prospective group member.

  • chat.bsky.convo.getConvoForMembers

    query

    Get or create a 1-1 conversation for the given members. Always returns the same direct (non-group) conversation. To create a group conversation, use createGroup.

  • fyi.opensocial.createGroup

    procedure

    Host-level: create a new group on this host. Authenticated as the founder (service auth from their PDS). The founder and any listed stewards become its first admins. Mints the group DID, creates the meta and members spaces, writes the bootstrap records and, for a discoverable group, a declaration. Modality spaces are left to the apps that use them (createSpace).