---
title: "Create Job Template"
method: POST
path: "/jobs/template"
---

# Create Job Template

`POST /jobs/template`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/jobs/template`
- Auth: API key in header `x-api-key`

Creates a job print/PDF template. Body must be nested under a `template` key. display_order is server-computed (max+1) and cannot be set directly. Unlike Job Category, this module has no admin/TL role restriction — any authenticated user can create/edit/delete/reorder templates.

## Request body

- object
  - `template` object, required
    - `template_name` string, required
    - `template_description` string
    - `job_category` string, required: A job category_uid.
    - `template` string: The template HTML body.
    - `header` string
    - `footer` string
    - `render_engine` 'PHANTOM' | 'PUPPETEER'
    - `template_options` object
      - `format` 'A3' | 'A4' | 'A5' | 'Legal' | 'Letter' | 'Tabloid'
      - `orientation` 'portrait' | 'landscape'
      - `border` object
        - `top` string
        - `right` string
        - `bottom` string
        - `left` string
    - `associated_to` string[]: Additional job category_uids this template is also associated with.

## Response `200`

200

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/jobs/template/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)