# social.coves.community.create

> Published by [coves.social](https://lexicon.garden/identity/did:web:coves.social)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.community.create)
- [Documentation](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.community.create/docs)
- [Examples](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.community.create/examples)

## Definitions

### `social.coves.community.create`

**Type**: `procedure`

Create a new community. Requires authentication.

#### Input

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | Short community name used as the local part of the handle (e.g., 'gaming'). Must be a valid DNS label: ASCII letters, digits, and hyphens only. |
| `rules` | `array` | No | Community rules |
| `language` | `string` (language) | No | Primary language of the community |
| `avatarBlob` | `string` | No | Base64-encoded avatar image data (png, jpeg, or webp) |
| `bannerBlob` | `string` | No | Base64-encoded banner image data (png, jpeg, or webp) |
| `categories` | `array` | No | Community categories for discovery |
| `visibility` | `string` | No | Community visibility level |
| `description` | `string` | Yes | Community description |
| `displayName` | `string` | No | Display name for the community |
| `avatarMimeType` | `string` | No | MIME type of the avatar image (image/png, image/jpeg, image/webp) |
| `bannerMimeType` | `string` | No | MIME type of the banner image (image/png, image/jpeg, image/webp) |
| `membershipThreshold` | `integer` | No | Reputation threshold required for membership |
| `allowExternalDiscovery` | `boolean` | No | Whether other Coves instances can index and discover this community |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | Yes | CID of the created community profile |
| `did` | `string` (did) | Yes | DID of the created community |
| `uri` | `string` (at-uri) | Yes | AT-URI of the created community profile |
| `handle` | `string` | Yes | Scoped handle of the created community (~name@instance) |

#### Errors

- **NameTaken**: Community name is already taken
- **TooManyCommunities**: User has reached the maximum number of communities they can create

## Raw Schema

```json
{
  "id": "social.coves.community.create",
  "defs": {
    "main": {
      "type": "procedure",
      "input": {
        "schema": {
          "type": "object",
          "required": [
            "name",
            "description"
          ],
          "properties": {
            "name": {
              "type": "string",
              "maxLength": 63,
              "description": "Short community name used as the local part of the handle (e.g., 'gaming'). Must be a valid DNS label: ASCII letters, digits, and hyphens only."
            },
            "rules": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 2000,
                "maxGraphemes": 200
              },
              "maxLength": 10,
              "description": "Community rules"
            },
            "language": {
              "type": "string",
              "format": "language",
              "description": "Primary language of the community"
            },
            "avatarBlob": {
              "type": "string",
              "maxLength": 1400000,
              "description": "Base64-encoded avatar image data (png, jpeg, or webp)"
            },
            "bannerBlob": {
              "type": "string",
              "maxLength": 2800000,
              "description": "Base64-encoded banner image data (png, jpeg, or webp)"
            },
            "categories": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 50
              },
              "maxLength": 3,
              "description": "Community categories for discovery"
            },
            "visibility": {
              "type": "string",
              "default": "public",
              "maxLength": 64,
              "description": "Community visibility level",
              "knownValues": [
                "public",
                "unlisted",
                "private"
              ]
            },
            "description": {
              "type": "string",
              "maxLength": 10000,
              "description": "Community description",
              "maxGraphemes": 1000
            },
            "displayName": {
              "type": "string",
              "maxLength": 1280,
              "description": "Display name for the community",
              "maxGraphemes": 128
            },
            "avatarMimeType": {
              "type": "string",
              "maxLength": 128,
              "description": "MIME type of the avatar image (image/png, image/jpeg, image/webp)"
            },
            "bannerMimeType": {
              "type": "string",
              "maxLength": 128,
              "description": "MIME type of the banner image (image/png, image/jpeg, image/webp)"
            },
            "membershipThreshold": {
              "type": "integer",
              "default": 100,
              "maximum": 10000,
              "minimum": 0,
              "description": "Reputation threshold required for membership"
            },
            "allowExternalDiscovery": {
              "type": "boolean",
              "default": true,
              "description": "Whether other Coves instances can index and discover this community"
            }
          }
        },
        "encoding": "application/json"
      },
      "errors": [
        {
          "name": "NameTaken",
          "description": "Community name is already taken"
        },
        {
          "name": "TooManyCommunities",
          "description": "User has reached the maximum number of communities they can create"
        }
      ],
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "uri",
            "cid",
            "did",
            "handle"
          ],
          "properties": {
            "cid": {
              "type": "string",
              "format": "cid",
              "description": "CID of the created community profile"
            },
            "did": {
              "type": "string",
              "format": "did",
              "description": "DID of the created community"
            },
            "uri": {
              "type": "string",
              "format": "at-uri",
              "description": "AT-URI of the created community profile"
            },
            "handle": {
              "type": "string",
              "maxLength": 512,
              "description": "Scoped handle of the created community (~name@instance)"
            }
          }
        },
        "encoding": "application/json"
      },
      "description": "Create a new community. Requires authentication."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```