# Create Attribute Group Endpoint

## Structure

### Attribute 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 attribute group</td><td>No</td></tr><tr><td>`name`</td><td>string</td><td>The name of the attribute group (e.g., Size or Colour)</td><td>Yes</td></tr><tr><td>`display_as`</td><td>string</td><td>The display as of the attribute group (e.g.: dropdown, color\_swatches, image\_swatches, swatches)</td><td>No</td></tr><tr><td>`reference`</td><td>string</td><td>The reference of the attribute group</td><td>No</td></tr><tr><td>`attributes`</td><td>array</td><td>The attributes of the attribute group, see [Attribute](https://support.aerocommerce.com/books/api/page/create-attribute-group-endpoint#bkmrk-attribute)</td><td>No</td></tr></tbody></table>

### Attribute

<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 attribute</td><td>No</td></tr><tr><td>`name`</td><td>string</td><td>The name of the attribute (e.g., Small or Red)</td><td>Yes</td></tr><tr><td>`display_name`</td><td>string</td><td>The display name of the attribute</td><td>No</td></tr><tr><td>`reference`</td><td>string</td><td>The reference of the attribute</td><td>No</td></tr><tr><td>`image`</td><td>object</td><td>The [Image](https://support.aerocommerce.com/books/api/page/create-attribute-group-endpoint#bkmrk-image) of the attribute</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-attribute-group-endpoint#bkmrk-tag) objects</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>

### Tag

<table border="1" id="bkmrk-name-type-descriptio-3" 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>`name`</td><td>string</td><td>The name of the tag (e.g., Small or Red)</td><td>Yes</td></tr><tr><td>`group`</td><td>object</td><td>The tag group, see [Tag Group](https://support.aerocommerce.com/books/api/page/create-attribute-group-endpoint#bkmrk-tag-group)</td><td>Yes</td></tr></tbody></table>

### Tag Group

<table border="1" id="bkmrk-name-type-descriptio-4" 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>`name`</td><td>string</td><td>The name of the tag group (e.g., Size or Colour)</td><td>Yes</td></tr></tbody></table>

## Example Request

```
POST /api/attribute-groups/
```

```json
{
    "name": "Colour",
    "attributes": [
        {
            "name": "Blue",
            "reference": "blue"
        },
        {
            "name": "red"
        }
    ]
}
```

## Example Response

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