# Create Size Guide Endpoint

<p class="callout warning">This endpoint is only available if `aerocargo/size-guides` is installed.</p>

## Structure

### Size Guide

<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 of the size guide</td><td>No</td></tr><tr><td>`name`</td><td>string</td><td>The name for the size guide</td><td>Yes</td></tr><tr><td>`heading`  
</td><td>string</td><td>The heading of the size guide</td><td>Yes</td></tr><tr><td>`view`  
</td><td>string</td><td>The view of the size guide</td><td>No</td></tr><tr><td>`small_image`</td><td>object</td><td>The Small [Image](https://support.aerocommerce.com/books/api/page/create-size-guide-endpoint#bkmrk-image)</td><td>No</td></tr><tr><td>`medium_image`</td><td>object</td><td>The Medium [Image](https://support.aerocommerce.com/books/api/page/create-size-guide-endpoint#bkmrk-image)</td><td>No</td></tr><tr><td>`large_image`</td><td>object</td><td>The Large [Image](https://support.aerocommerce.com/books/api/page/create-size-guide-endpoint#bkmrk-image)</td><td>No</td></tr><tr><td>`products`  
</td><td>array</td><td>An array of product ids or models</td><td>Conditional `*`</td></tr><tr><td>`manufacturers`  
</td><td>array</td><td>An array of manufacturer ids or names</td><td>Conditional `*`</td></tr><tr><td>`categories`  
</td><td>array</td><td>An array of category ids or breadcrumbs</td><td>Conditional `*`</td></tr><tr><td>`tags`  
</td><td>array</td><td>An array of tag ids or names</td><td>Conditional `*`</td></tr><tr><td>`groups`  
</td><td>array</td><td>An array of [Group](https://support.aerocommerce.com/books/api/page/create-size-guide-endpoint#bkmrk-group) objects</td><td>No</td></tr></tbody></table>

`*` Either `products` is required or `manufacturers` and/or `categories` and/or `tags` are.

### Group

<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 of the size guide group</td><td>No</td></tr><tr><td>`heading`  
</td><td>string</td><td>The heading of the size guide</td><td>Yes</td></tr><tr><td>`sections`  
</td><td>array</td><td>An array of [Section](https://support.aerocommerce.com/books/api/page/create-size-guide-endpoint#bkmrk-section) objects</td><td>No</td></tr></tbody></table>

### Section

<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>`id`</td><td>int</td><td>The id of the size guide section</td><td>No</td></tr><tr><td>`heading`  
</td><td>string</td><td>The heading of the size guide section</td><td>Yes</td></tr><tr><td>`content`  
</td><td>string</td><td>The content of the size guide section</td><td>Yes</td></tr></tbody></table>

### Image

<table border="1" id="bkmrk-name-type-descriptio-3" style="border-collapse: collapse; width: 100%; height: 169.578px;"><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 style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td><td style="height: 29.7969px;">**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/size-guides/
```

## Example Response

```json
{
    "name": "API Test",
    "heading": "Test",
    "view": "test",
    "products": [],
    "manufacturers": [
        "Burberry",
    ],
    "categories": [
        "Mens > Coats",
    ],
    "tags": [
        "Blue",
    ],
    "groups": [
        {
            "heading": "Group Heading",
            "sections": [
                {
                    "heading": "Section Heading",
                    "content": "Section Content"
                }
            ]
        }
    ]
}
```