# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.kis.work/documentation/documentation-api/donnees-dune-table-de-donnees/creer-de-la-donnee.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.