generator/create

How to create a presentation

Use this endpoint to create a new presentation from a .pptx template file and JSON data.

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 file(s)
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": 429,
  "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'     # name used in upload + JSON (must match)
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 the Authorization tab, enter your Token .

   
2. Select the Body tab, select form-data , 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

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