# Create Tag Group Endpoint

## Structure

### Tag Group

<table border="1" id="bkmrk-name-type-descriptio" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td><td>**Required**  
</td></tr><tr><td>`id`</td><td>int</td><td>The id for the tag group</td><td>No</td></tr><tr><td>`name`</td><td>string</td><td>The name of the tag group (e.g., Size or Colour)</td><td>Yes</td></tr><tr><td>`reference`</td><td>string</td><td>The reference of the tag group</td><td>No</td></tr><tr><td>`show_in_filters`</td><td>boolean</td><td>Whether the tag group shows in filters on listings page (defaults to `true`)</td><td>No</td></tr><tr><td>`tags`</td><td>array</td><td>An array of [Tag](https://support.aerocommerce.com/books/api/page/create-tag-group-endpoint#bkmrk-tag) objects</td><td>No</td></tr></tbody></table>

### Tag

<table border="1" id="bkmrk-name-type-descriptio-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td><td>**Required**  
</td></tr><tr><td>`id`</td><td>int</td><td>The id for the tag</td><td>No</td></tr><tr><td>`name`</td><td>string</td><td>The name of the tag (e.g., Small or Red)</td><td>Yes</td></tr><tr><td>`slug`</td><td>string</td><td>The slug of the tag, if not present it is auto-generated from name (unless `has_slug` is `false`)</td><td>Conditional</td></tr><tr><td>`reference`</td><td>string</td><td>The reference of the tag</td><td>No</td></tr><tr><td>`image`</td><td>object</td><td>The [Image](https://support.aerocommerce.com/books/api/page/create-tag-group-endpoint#bkmrk-image) of the tag</td><td>No</td></tr><tr><td>`has_slug`</td><td>boolean</td><td>Whether the tag has a slug or not (defaults to `false`, unless `slug` is provided)</td><td>No</td></tr></tbody></table>

### Image

<table border="1" id="bkmrk-name-type-descriptio-2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td><td>**Required**  
</td></tr><tr><td>`src`</td><td>string</td><td>The source url of the image</td><td>Yes</td></tr></tbody></table>

## Example Request

```
POST /api/tag-groups/
```

```json
{
    "name": "Colour",
    "show_in_filters": false,
    "tags": [
        {
            "name": "Blue",
            "slug": "blueeee",
            "reference": "blue"
        },
        {
            "name": "red",
            "has_slug": false
        }
    ]
}
```

## Example Response

```json
{
    "tagGroup": {
        "id": 1
    }
}
```