> ## Documentation Index
> Fetch the complete documentation index at: https://resources.begenuin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create community

The Create Community API enables developers to create a new community within the platform programmatically. This API is crucial for automating community setup, allowing for seamless integration with your application or service.

**URL**  :  `/api/thirdparty/community/create`

**Method**  :  `POST`

**Auth required**  : YES

**Mandatory Fields**: handle, name, type, actions

**Note** : You need to Authorize [gn-access-token](https://resources.begenuin.com/developers/authentication) as `Bearer Token` to run the API.

# Request Body

```
{
  "handle": "genuin-community",
  "name": "Genuin Community",
  "description": "some community description #genuinCommunity #genuinAmdCommunity",
  "tags": "genuinCommunity,genuinAmdCommunity",
  "dp": "1.png",
  "categories": {
    "existing": [
      1,
      2
    ],
    "new": [
      "abc",
      "aAa",
      "xYZ"
    ]
  },
  "is_ai_generated": false,
  "is_ai_generated_dp": true,
  "is_ai_generated_banner": true,
  "banner": "1.png",
  "users": [
    {
      "user_id": "b12f13af-ef5a-4906-b0a0-2995e106200d"
    }
  ]
}
```

## Success Response

**Condition**: If Everything is okay and community is created.

**Code**: `200`

**Content**

```json theme={null}
{
  "code": 200,
  "message": "XXXX-[Community has been created successfully.]",
  "data": {
    "community_id": "0a2be302-04af-4642-a436-1612554e48a6",
    "share_url": "https://community.dhruvpatel.com/community/dqwd-w5oa",
    "dp": "https://media.qa.begenuin.com/uploads/profile_images/community/eeqfwee12.png",
    "banner": "https://media.qa.begenuin.com/uploads/community/banner/dqwdq.png",
    "color_code": "#A4E6DA",
    "text_color_code": "#49CDB5",
    "leader": {
      "member_id": "0bf977ed-4887-4056-a8f4-1f0de71101f1",
      "name": "hoo hwwoo",
      "bio": "jai hwwooo",
      "nickname": "wdqwdqwdq",
      "phone": "91333333333333",
      "is_brand_system_user": true,
      "is_avatar": false,
      "brand": {
        "brand_id": 1,
        "brand_slug": "dqwd-dqjb"
      },
      "profile_image": "https://media.qa.begenuin.com/uploads/profile_images/1706610191569_Vector.png",
      "profile_image_s": "https://media.qa.begenuin.com/uploads/profile_images/s/1706610191569_Vector.png",
      "profile_image_m": "https://media.qa.begenuin.com/uploads/profile_images/m/1706610191569_Vector.png",
      "profile_image_l": "https://media.qa.begenuin.com/uploads/profile_images/l/1706610191569_Vector.png"
    }
  }
}
```

**Note**: In the `community_id` you will get the actual ID of community and the link from `share_url`

## Bad Request

**Condition**: If the request contains errors or invalid data, resulting in the community not being created.

**Code**: `400`

**Content**

```
{}
```

## Invalid API Usage

**Condition**: "If the community categories do not exist or there is invalid use of the API, a `404` or `412` error is returned, respectively.

> Category Doesn't exists

**Code**: `404`

**Content**

```json theme={null}
{
  "code": "5220",
  "message": "XXXX-[community categories does not exists.]",
  "data": {}
}
```

> Invalid Usage of API

**Code**: `412`

**Content**

```json theme={null}
{
  "code": "5166",
  "message": "XXXX-[Invalid Use of API]",
  "data": {}
}
```

## Internal Server Error

**Condition**: If an unexpected issue occurs on the server, an `Internal Server Error` is returned.

**Code**: `500`

**Content**

```json theme={null}
{
  "code": "5216",
  "message": "XXXX-[community handle already exists.]",
  "data": {}
}
```