# Créer de la donnée

Créer un ou plusieurs éléments dans une table de données

### Requête

{% code overflow="wrap" lineNumbers="true" %}

```bash
curl --request POST \
     --url https://api.getkis.io/api/v1/api_token_access/data_handlers \
     --header 'Authorization: Bearer ...' \
     --header 'accept: text/plain' \
     --header 'content-type: application/json' \
     --data '
{
     "data_handler": {
          "collection_name": "voitures",
    			"documents": [
              {
                "marque": "peugeot",
                "couleur": "rouge",
                "localisation": "paris",
                "stock": 1380
              }, {
                "marque": "renault",
                "couleur": "jaune",
                "localisation": "toulouse",
                "stock": 392
              }
         ]
     }
}
```

{% endcode %}

### Paramètre

| Paramètre         | Type             | Description                                                             | Obligatoire ? |
| ----------------- | ---------------- | ----------------------------------------------------------------------- | ------------- |
| `collection_name` | String           | Nom de la table de données dans laquelle créer la donnée                | Oui           |
| `documents`       | Array of Objects | Tableau d'Objets contenant les données à créer dans la table de données | Oui           |

Le champs `documents` doit être composé de d'Objects ayant la structure suivante :

JSON

```json
{
  "documents": [
    {
      "champs_de_votre_table_1": "valeur de votre choix",
      "champs_de_votre_table_2": "valeur de votre choix",
    }
  ]
}
```

{% hint style="info" %}

### 📘Information

Dans les Objects du champs `documents` vous devez respecter l'orthographe des champs créés dans la structure de votre table de données. Vous n'êtes pas obligé de renseigner tous les champs de la structure de votre table de données.
{% endhint %}

{% hint style="danger" %}

### ❗️Attention

Si dans un Object du champs `documents` vous renseignez un champs qui ne correspond pas à un existant dans la structure de votre table de données, la requête n'aboutira pas.
{% endhint %}