# usermacro.createglobal

### Description

`object usermacro.createglobal(object/array globalMacros)`

This method allows to create new global macros.

### Parameters

`(object/array)` Global macros to create.

The method accepts global macros with the [standard global macro
properties](definitions#global_macro).

### Return values

`(object)` Returns an object containing the IDs of the created global
macros under the `globalmacroids` property. The order of the returned
IDs matches the order of the passed global macros.

### Examples

#### Creating a global macro

Create a global macro "{$SNMP\_COMMUNITY}" with value "public".

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "usermacro.createglobal",
    "params":  {
        "macro": "{$SNMP_COMMUNITY}",
        "value": "public"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "globalmacroids": [
            "6"
        ]
    },
    "id": 1
}
```

### Source

CUserMacro::createGlobal() in
*frontends/php/api/classes/CUserMacro.php*.