# JSON



## What you can do with this integration

The integration for JSON lets you:

* **Read user data from a JSON file** and unify them as user profiles inside Krenalis.
* **Write unified users back into JSON** and keep the target synchronized over time.

You can use it both to **collect user data** and to **activate user profiles**.

<ul class="cards" data-columns="2">
  <li>
    <a href="/docs/ingest-users/files?format=json">
      <figure><img src="%3cp%3e/docs/integrations/images/json.svg%3c/p%3e%0a" alt="JSON"></figure>
      <div>Ingest users</div>
      <p>Read and sync user data from a JSON file.</p>
    </a>
  </li>
  <li>
    <a href="/docs/activate-profiles/files?format=json">
      <figure><img src="%3cp%3e/docs/integrations/images/json.svg%3c/p%3e%0a" alt="JSON"></figure>
      <div>Activate users</div>
      <p>Write unified profiles to a JSON file and keep the data updated.</p>
    </a>
  </li>
</ul>

## Imported JSON format

JSON files containing an Array of Objects are supported, where each Object maps properties to values, as in this example:

```json
[
    {
        "name": "John",
        "email": "john@example.com",
        "score": 328.2
    },
    {
        "name": "Paul",
        "email": "paul@example.com",
        "score": 240.2
    }
]
```

Or JSON files containing an Object with a single key — regardless of what that key is — whose associated value is an Array of Objects, with the same structure as the previous example, are supported:

```json
{
    "some_key_name": [
        {
            "name": "John",
            "email": "john@example.com",
            "score": 328.2
        },
        {
            "name": "Paul",
            "email": "paul@example.com",
            "score": 240.2
        }
    ]
}
```

Any other JSON format is not supported at this time.

## Exported JSON format

The exported JSON file is a JSON Object containing a single key, `"records"`, whose value is an array containing the various objects representing the exported users. For example:

```json
{
    "records": [
        {
            "name": "John",
            "email": "john@example.com",
            "score": 328.2
        },
        {
            "name": "Paul",
            "email": "paul@example.com",
            "score": 240.2
        }
    ]
}
```