---
title: "Creating a new Project Template"
method: POST
path: "/project_templates"
tags: ["Project Templates"]
---

# Creating a new Project Template

`POST /project_templates`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/project_templates`
- Auth: none declared

This endpoint returns structured Project Template objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `project_templates` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string
- `optional_fields` string[]

## Request body

- object
  - `project_template` object
    - `title` string, required: The title of the project template.
    - `sharing` 'private_template' | 'viewable_template' | 'editable_template': The sharing setting for the template. Viewable and editable templates can be seen by users on the account other than the creator.
    - `is_budgeted` boolean: The project template has financial attributes including overall budget, task budgets, and task time estimates.
    - `budget` integer: The estimated overall budget of the project associated with the template.
    - `duration` integer: The estimated number of days that the associated project will take.
    - `currency` string, required: The currency of the project template.
    - `description` string: A description of the project template which does not carry over to the project description when applied.
    - `raw_json` string: A JSON hash that contains all project templates' tasks.

## Response `200`

Project Template has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `project_templates` object
  - `users` object
  - `project_template_assignments` object
  - `project_template_additional_tabs` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)