chat.bsky.group.createGroup

bsky-lexicons.bsky.social

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "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'.",
      "errors": [
        {
          "name": "AccountSuspended"
        },
        {
          "name": "BlockedActor"
        },
        {
          "name": "BlockedSubject"
        },
        {
          "name": "NewAccountCannotCreateGroup"
        },
        {
          "name": "NotFollowedBySender"
        },
        {
          "name": "RecipientNotFound"
        },
        {
          "name": "UserForbidsGroups"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "members": {
              "description": "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.",
              "items": {
                "format": "did",
                "type": "string"
              },
              "maxLength": 10000,
              "type": "array"
            },
            "name": {
              "maxGraphemes": 50,
              "maxLength": 500,
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "members",
            "name"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "convo": {
              "ref": "chat.bsky.convo.defs#convoView",
              "type": "ref"
            }
          },
          "required": [
            "convo"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "chat.bsky.group.createGroup",
  "lexicon": 1
}

Validate Record

Validate a record against chat.bsky.group.createGroup

Validation Options
Automatically resolve and include external schemas for full validation
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:4v4y5r3lwsbtmsxhile2ljac
CID
bafyreidhalpchhospn2hwox54navotl4svw4pmt33aynj22gp52ofoxzau
Indexed At
2026-08-03 16:20 UTC
AT-URI
at://did:plc:4v4y5r3lwsbtmsxhile2ljac/com.atproto.lexicon.schema/chat.bsky.group.createGroup

Version History (3 versions)

Referenced Schemas (1)

Similar Lexicons

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

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

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

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

  • 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.

  • 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 spa…

Lexicon Garden

@