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

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

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

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

Cette méthode permet de créer de nouveaux objets connecteur.

::: noteclassic
Cette méthode est disponible uniquement pour le type d’utilisateur *Super admin*. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/users/user_roles) pour plus d’informations.
:::

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

[comment]: # ({e144b89b-98722c06})
### Paramètres

`(object/array)` Objets connecteur à créer.

En plus des [propriétés standard du connecteur](object#connector), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tags|array|[Filtre de tags](/manual/api/reference/connector/object#tag-filter) du connecteur.|

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

[comment]: # ({d4487654-a513e07e})
### Valeurs de retour

`(object)` Renvoie un objet contenant les IDs des connecteurs créés sous la propriété `connectorids`.
L’ordre des IDs renvoyés correspond à l’ordre des connecteurs transmis.

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

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

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

[comment]: # ({88c51e60-5936d90d})
#### Création d’un connecteur

Créez un connecteur pour exporter les événements de déclencheur avec un filtre de balises. L’authentification HTTP sera effectuée à l’aide d’un jeton Bearer.

[Requête](/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
}
```

Réponse :

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

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

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

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

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