> For the complete documentation index, see [llms.txt](https://docs.pptxbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pptxbuilder.com/api-reference/json-pptx.md).

# JSON to PPTX Builder

This page describes the endpoint used to convert json data into a pptx builder project.

This endpoint is used to load your `json` data in [PPTX Builder](https://www.pptxbuilder.com/) platform as a project. You will receive a `URL` that will redirect you to the platform and open your newly created project. 

Anyone with access to the `URL` will have ability to view and edit the project. After each download/save action, we will send an updated payload through the `webhook` which will contain the updated settings.

All changes made when accessing the project through the `URL` are stored in the Database.

## Convert

<mark style="color:green;">`POST`</mark> `https://api.pptxbuilder.com/api/v2/convert_data_to_pptx`

This endpoint allows you to convert `json` into a pptx builder project.

#### Headers

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| Content-Type  | string | multipart/form-data |
| Authorization | string | Bearer \<token>     |

#### Request Body

| Name       | Type   | Description                            |
| ---------- | ------ | -------------------------------------- |
| json\_data | object | Data to be rendered in the PPTXBuilder |
| pptx\_file | string | \<pptx file template>                  |

{% tabs %}
{% tab title="200 PPTX successfully created." %}

```
{
    "url": "https://pptxbuilder.com/builder/preview?token=<token>"
}
```

{% endtab %}

{% tab title="400 Wrong json data format or missing parameters." %}

```
{
    "error": "Expected <> object to be given, instead got <class 'NoneType'>"
}
```

{% endtab %}

{% tab title="401 Token not valid." %}

```
{
    "error": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
The returned `url` and data is stored in the database for 72 hours. After 72 hours the data will be deleted from the database and the `url` will be deactivated. You can change this in the [Settings](http://api.pptxbuilder.com/api/settings) and provide a new *API Data Accessible* (time unit - hours).
{% endhint %}