[comment]: # translation:outdated

[comment]: # ({5c2c8c32-2a00571f})
# connector.create

[comment]: # ({/5c2c8c32-2a00571f})

[comment]: # ({abae348f-bad67477})
### Beschreibung

`object connector.create(object/array connectors)`

Mit dieser Methode können Sie neue Konnektor-Objekte erstellen.

::: noteclassic
Diese Methode ist nur für den Benutzertyp *Superadmin* verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrolleneinstellungen entzogen werden.
Prüfen Sie [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles) für mehr Informationen.
:::

[comment]: # ({/abae348f-bad67477})

[comment]: # ({e144b89b-98722c06})
### Parameter

`(object/array)` Zu erstellende Connector-Objekte.

Zusätzlich zu den [Standard-Connector-Eigenschaften](object#connector) akzeptiert die Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|tags|array|Connector-[Tag-Filter](/manual/api/reference/connector/object#tag-filter).|

[comment]: # ({/e144b89b-98722c06})

[comment]: # ({d4487654-a513e07e})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der erstellten Verbindungen unter der Eigenschaft `connectorids` enthält.
Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Konnektoren.

[comment]: # ({/d4487654-a513e07e})

[comment]: # ({b41637d2-983d5841})
### Beispiele

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

[comment]: # ({88c51e60-5936d90d})
#### Erstellen eines Verbinders

Erstellen Sie einen Connector, um Auslöser (trigger)-Ereignisse mit einem Tag-Filter zu exportieren. Die HTTP-Authentifizierung wird mit einem Bearer-Token durchgeführt.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "connector.create",
    "params": [
        {
            "name": "Export of events",
            "data_type": 1,
            "url": "{$DATA_EXPORT_URL}",
            "authtype": 5,
            "token": "{$DATA_EXPORT_BEARER_TOKEN}",
            "tags": [
                {
                    "tag": "service",
                    "operator": 0,
                    "value": "mysqld"
                }
            ]
        }
    ],
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "connectorid": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/88c51e60-5936d90d})

[comment]: # ({af9876f9-6550862d})
### Quelle

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

[comment]: # ({/af9876f9-6550862d})