[comment]: # ({e1d82d97-e1d82d97})
# templatescreen.create

[comment]: # ({/e1d82d97-e1d82d97})

[comment]: # ({0da15fe2-0da15fe2})
### Description

`object templatescreen.create(object/array templateScreens)`

This method allows to create new template screens.

[comment]: # ({/0da15fe2-0da15fe2})

[comment]: # ({117bff85-515daa41})
### Parameters

`(object/array)` Template screens to create.

Additionally to the [standard template screen
properties](object#template_screen), the method accepts the following
parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|**screenitems**|array|Template [screen items](/manual/api/reference/templatescreenitem/object) to create on the screen.|

[comment]: # ({/117bff85-515daa41})

[comment]: # ({8b0b6808-8b0b6808})
### Return values

`(object)` Returns an object containing the IDs of the created template
screens under the `screenids` property. The order of the returned IDs
matches the order of the passed template screens.

[comment]: # ({/8b0b6808-8b0b6808})

[comment]: # ({b41637d2-b41637d2})
### Examples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({68998cc2-68998cc2})
#### Create a template screen

Create a template screen named “Graphs” with 2 rows and 3 columns and
add a graph to the upper-left cell.

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "templatescreen.create",
    "params": {
        "name": "Graphs",
        "templateid": "10047",
        "hsize": 3,
        "vsize": 2,
        "screenitems": [
            {
                "resourcetype": 0,
                "resourceid": "410",
                "x": 0,
                "y": 0
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "screenids": [
            "45"
        ]
    },
    "id": 1
}
```

[comment]: # ({/68998cc2-68998cc2})

[comment]: # ({ac17b1a3-ac17b1a3})
### See also

-   [Template screen
    item](/manual/api/reference/templatescreenitem/object#template_screen_item)

[comment]: # ({/ac17b1a3-ac17b1a3})

[comment]: # ({ef1f4b5d-ef1f4b5d})
### Source

CTemplateScreen::create() in
*ui/include/classes/api/services/CTemplateScreen.php*.

[comment]: # ({/ef1f4b5d-ef1f4b5d})