---
title: "Create a new project"
method: POST
path: "/automation-studio/projects"
tags: ["Automation Studio"]
---

# Create a new project

`POST /automation-studio/projects`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/automation-studio/projects`
- Auth: none declared

Creates a new project.

## Request body

- AutomationStudioProjectsCreateData: POST body properties required to create a project
  - `name` string, required: Project name
  - `description` string: A free-form block of text for describing project intent and function
  - `components` AutomationStudioProjectsCreateDataComponentsItems[]: A list of member components in the project
    - `iid` integer: Incrementing integer ID
    - `type` 'workflow' | 'jsonForm' | 'mopAnalyticTemplate' | 'mopCommandTemplate' | 'template' | 'transformation': String denoting the type of component
    - `reference` string
    - `folder` string

## Response `200`

Create result

- AutomationStudioCreateProjectResponse200
  - `message` string
  - `data` AutomationStudioProjectsHttp: Project data as it is sent back from get and search endpoints
    - `_id` string: A string representation of a MongoDB ObjectId
    - `iid` integer: Incrementing integer ID
    - `name` string: Project name
    - `description` string: A free-form block of text for describing project intent and function
    - `members` AutomationStudioProjectsHttpMembersItems[]
      - `type` 'account' | 'group', required
      - `reference` string, required: A string representation of a MongoDB ObjectId
      - `role` 'owner' | 'editor' | 'operator' | 'viewer', required
      - `missing` boolean
      - `username` string
      - `name` string
      - `provenance` string
    - `accessControl` AutomationStudioProjectsHttpAccessControl
      - `read` string[], required
      - `execute` string[], required
      - `write` string[], required
      - `manage` string[], required
    - `componentIidIndex` integer: Read-only property providing incrementing integer ID values for child components within a project
    - `components` AutomationStudioProjectsHttpComponentsItems[]: A list of member components in the project
      - `iid` integer: Incrementing integer ID
      - `type` 'workflow' | 'jsonForm' | 'mopAnalyticTemplate' | 'mopCommandTemplate' | 'template' | 'transformation': String denoting the type of component
      - `reference` string
      - `folder` string
    - `folders` AutomationStudioProjectsHttpFoldersItems[]: A list of folders and their members
      - union
        - AutomationStudioProjectsHttpFoldersItems0
          - `nodeType` 'folder' | 'component', required: String denoting the nodeType of the folder node
          - `name` string, required: Folder name
          - `children` AutomationStudioProjectsHttpFoldersItemsOneOf0ChildrenItems[], required
            - union
              - …
        - AutomationStudioProjectsHttpFoldersItems1
          - `iid` integer, required: Incrementing integer ID
          - `nodeType` 'folder' | 'component', required: String denoting the nodeType of the folder node
          - `type` 'workflow' | 'jsonForm' | 'mopAnalyticTemplate' | 'mopCommandTemplate' | 'template' | 'transformation': String denoting the type of component
          - `reference` string
    - `created` string, date-time: ISO Date String
    - `createdBy` unknown
    - `lastUpdated` string, date-time: ISO Date String
    - `lastUpdatedBy` unknown
    - `versionHistory` AutomationStudioProjectsHttpVersionHistoryItems[]
      - `versionNumber` integer, required
      - `commitMessage` string, required
      - `author` string, required
      - `branchName` string, required
    - `gitConfiguration` AutomationStudioProjectsHttpGitConfiguration
      - `connectionType` 'GitHub' | 'GitLab', required
      - `repositoryPath` string, required
      - `branchName` string, required
      - `projectPath` string, required
  - `metadata` AutomationStudioProjectsPostResponsesContentApplicationJsonSchemaMetadata

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Automation Studio` added
  - api tag `automationStudio` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/automation-studio/projects/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)