Templating your presentation

Using template PowerPoint with slides enables you to style and layout your API generated presentation exactly how you want it.

There are two methods for including your template PowerPoint file for an API request.

Option 1. Include a URL link to your .pptx template file in your API request. Option 2. Attach the .pptx template file in your API request.

Option 1: Include your template file using a URL link

If your template PowerPoint file is large, it may be optimal to use a downloadable URL link to your template presentation.

Here's how to share your template PowerPoint file with the API, via a link:

1. Save your template PowerPoint presentation somewhere you can create an open download link. Here's how to do it with Google Drive:

1.1. Upload your template PowerPoint file to Google Drive.

1.2. Right Click on your file and select ‘Get Link’.

1.3. In the Get link window, make sure the section General access is "Anyone with the link".

1.4. Click the ‘Copy Link’.

1.5. Convert your link from a 'Sharing' link to a 'Download' link using this free tool: https://sites.google.com/site/gdocs2direct/

2. Include the download URL link to your template PowerPoint file in your JSON payload:

{
  "presentation": {
    "template": "https://drive.google.com/uc?export=download&id=1-9mrTXvFaVSwJTU7F_3eKJzRY3TUR_tE",
    "export_version": "Pptx2010",
      ....

Using this method you will only need to refer to the download link, without needing to send the template file.

Creating your first presentation

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

Headers

Name	Type	Description
Content-Type*	string	application/x-www-form-urlencoded
Authorization*	string	Bearer authorization token

Request Body

Name	Type	Description
jsonData*	string	JSON payload which contains the presentation definition

200

Option 2: Attach your template file directly

If your template PowerPoint file is small, or you have concerns over creating an unrestricted download link to your template presentation, you can opt to send it along with every request to the API:

1. Include your template PowerPoint file as a "file" with your POST request to the API.

2. Include a reference to your template file by name in the JSON payload:

{
  "presentation": {
    "template": "slides_as_template.pptx",
    "export_version": "Pptx2010",
    ....

Creating your first presentation

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

Headers

Name	Type	Description
Content-Type*	string	multipart/form-data
Authentication*	string	Bearer authentication token

Request Body

Name	Type	Description
files	object	PPTX file used as styling and layout template
jsonData*	string	JSON payload which contains the presentation definition

200