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": {
              "items": {
                "format": "did",
                "type": "string"
              },
              "maxLength": 49,
              "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
bafyreicpqjbpipx4mxby5mujguw2rwpewycm2h6ybbdiycdnghxqgertju
Indexed At
2026-07-16 14:58 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

@