[comment]: # ({b2d566b4-b2d566b4})
# screenitem.create

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

[comment]: # ({d458a71b-d458a71b})
### Description

`object screenitem.create(object/array screenItems)`

This method allows to create new screen items.

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

[comment]: # ({b2879324-b2879324})
### Parameters

`(object/array)` Screen items to create.

The method accepts screen items with the [standard screen item
properties](object#screen_item).

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

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

`(object)` Returns an object containing the IDs of the created screen
items under the `screenitemids` property. The order of the returned IDs
matches the order of the passed screen items.

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

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

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

[comment]: # ({36694153-36694153})
#### Creating a screen item

Create a screen item displaying a graph in the left-upper cell of the
screen.

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screenitem.create",
    "params": {
        "screenid": 16,
        "resourcetype": 0,
        "resourceid": 612,
        "x": 0,
        "y": 0
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "screenitemids": [
            "65"
        ]
    },
    "id": 1
}
```

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

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

-   [screen.update](/manual/api/reference/screen/update)

[comment]: # ({/9dd8f3de-9dd8f3de})

[comment]: # ({6d1c39c8-6d1c39c8})
### Source

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

[comment]: # ({/6d1c39c8-6d1c39c8})