POST /generator/create

Use this endpoint to create a new presentation from a .pptx template file and JSON data . The call is synchronous — the connection stays open while the presentation is built, and the finished file comes back in the same response.

Synchronous or asynchronous?

Both endpoints take exactly the same files and jsonData payload, use the same token, and count towards the same usage allowance. If this endpoint is timing out on a large presentation, switch to generator/create-async — the request itself is unchanged, you only add the polling step.

	generator/create (v1.0)	generator/create-async (v2.0)
Style	Synchronous — one request	Asynchronous — submit, then poll
Response	The .pptx file as a binary stream	JSON containing a job ID
Connection held open	For the whole generation	Only long enough to upload the template and JSON
Best for	Small and medium decks, quick interactive calls	Large decks — many slides, large tables, charts and images
Risk	Client, proxy or gateway timeouts on long jobs	None — generation time is decoupled from the request

generator/create

POST https://gen.powerpointgeneratorapi.com/v1.0/generator/create

Headers

Name	Type	Description
Content-Type*	String	multipart/form-data
Authorization*	String	Bearer authentication token

Request Body

Name	Type	Description
files*	File or array of files	.pptx template file(s), plus any image files
jsonData*	String	JSON data

200: OK

On success, the API returns the generated file as a binary stream (not JSON).

Header	Description
Content-Type	Matches the requested output format
Content-Disposition	Attachment; filename={filename}

Save the response body directly to a file to get the presentation.

400: Bad Request

Returns a JSON error object describing what was invalid.

{
    "statusCode": 400,
    "message": "Invalid input parameters",
    "details": "{more information}",
}

401: Unauthorized

{
  "statusCode": 401,
  "message": "Unauthorized",
  "detail": "The bearer token is missing, expired, or invalid."
}

429: Too Many Requests

{
  "statusCode": 429,
  "message": "Too Many Requests - usage or rate limit exceeded",
  "detail": "Too many requests: monthly slide limit exceeded."
}

500: Internal Server Error

{
  "statusCode": 500,
  "title": "Error",
  "detail": "An error occurred while generating the presentation. See server logs for details."
}

Example request

Dummy PowerPoint template used in examples below:

title_slide_template.pptx

517KB

Open

cURL

curl --location --request POST 'https://gen.powerpointgeneratorapi.com/v1.0/generator/create' \
  -H 'Authorization: Bearer {add_your_token_here}' \
  -F 'files=@title_slide_template.pptx' \
  -F 'jsonData={"presentation":{"template":"title_slide_template.pptx","export_version":"Pptx2019","resultFileName":"quick_start_example","slides":[{"type":"slide","slide_index":0,"shapes":[{"name":"Title 1","content":"Your generated PowerPoint presentation"},{"name":"Subtitle 2","content":"Create, fill and manage PowerPoint documents through simple API requests."}]}]}}' \
  --output generated.pptx

Python

import json
import requests

TEMPLATE_PATH = './title_slide_template.pptx'   # where the file lives on disk
TEMPLATE_NAME = 'title_slide_template.pptx'     # upload name, same as jsonData "template"
API_TOKEN = 'eyJ...'                            # your bearer token

payload = {
    'jsonData': json.dumps({
        "presentation": {
            "template": TEMPLATE_NAME,
            "export_version": "Pptx2019",
            "resultFileName": "quick_start_example",
            "slides": [
                {
                    "type": "slide",
                    "slide_index": 0,
                    "shapes": [
                        {"name": "Title 1", "content": "Your generated PowerPoint presentation"},
                        {"name": "Subtitle 2", "content": "Create, fill and manage PowerPoint documents through simple API requests."},
                    ],
                }
            ],
        }
    })
}

with open(TEMPLATE_PATH, 'rb') as f:
    files = [
        ('files', (TEMPLATE_NAME, f,
                   'application/vnd.openxmlformats-officedocument.presentationml.presentation'))
    ]
    response = requests.post(
        'https://gen.powerpointgeneratorapi.com/v1.0/generator/create',
        data=payload,
        files=files,
        headers={'Authorization': f'Bearer {API_TOKEN}'},
        timeout=360,
    )

print(response.status_code, response.headers.get('Content-Type'))

if response.ok:
    with open("./generated.pptx", "wb") as out:
        out.write(response.content)
    print("saved generated.pptx", len(response.content), "bytes")
else:
    print(response.text)

JavaScript

const TEMPLATE_NAME = "title_slide_template.pptx"; // upload name + JSON "template" (must match)
const API_TOKEN = "add_your_token_here";

const jsonData = {
  presentation: {
    template: TEMPLATE_NAME,
    export_version: "Pptx2019",
    resultFileName: "quick_start_example",
    slides: [
      {
        type: "slide",
        slide_index: 0,
        shapes: [
          { name: "Title 1", content: "Your generated PowerPoint presentation" },
          { name: "Subtitle 2", content: "Create, fill and manage PowerPoint documents through simple API requests." },
        ],
      },
    ],
  },
};

// templateFile is a File/Blob, e.g. from <input type="file" id="template">:
// const templateFile = document.getElementById("template").files[0];

async function generate(templateFile) {
  const formData = new FormData();
  formData.append("jsonData", JSON.stringify(jsonData));
  formData.append("files", templateFile, TEMPLATE_NAME);

  const response = await fetch(
    "https://gen.powerpointgeneratorapi.com/v1.0/generator/create",
    {
      method: "POST",
      headers: { Authorization: `Bearer ${API_TOKEN}` },
      body: formData,
    }
  );

  if (!response.ok) {
    console.error(response.status, await response.text());
    return;
  }

  const blob = await response.blob();
  const link = document.createElement("a");
  link.href = URL.createObjectURL(blob);
  link.download = "generated.pptx";
  link.click();
  URL.revokeObjectURL(link.href);
}

Postman

1

Select Authorization

Select the Authorization tab, enter your Token.

2

Configure the request body

Select the Body tab, select form-data, and add the two key-value parameters below:

KEY	VALUE
files	upload/ attach your .pptx file
jsonData	copy and paste the data from your .json payload

3

Send and download

Click the down arrow next to Send, then select Send and Download. Once the result is successfully received, save the output as .pptx.