---
title: "admCreateProject"
canonical: "https://support.appfire.com/space/PSJ/15480983/admCreateProject"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | admCreateProject(pkey, pname, description, lead, url, categoryName, defaultIsUnassigned, avatarId[, projectTypeKey]) | **Package** | adm |
| **Alias** |  | **Pkg Usage** | createProject(pkey, pname, description, lead, url, categoryName, defaultIsUnassigned, avatarId[, projectTypeKey]) |

## Description

> Macro (excerpt)
> 
> Creates a new project, optionally offering support for category of the project

Creates a new project, optionally offering support for category of the project

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| pkey | String | Yes | Project key |
| pname | String | Yes | Project name. |
| description | String | Yes | Project description. |
| lead | String | Yes | Represents a valid user that should be assignable on the project. |
| url | String | Yes | URL of the project. Leave blank if no URL is available. |
| categoryName | String | Yes | Name of the category. |
| defaultIsUnassigned | Boolean (true/false) | Yes | Set it to 'true' if you don't want to assign issues to the project lead above. |
| avatarId | numeric | Yes | Set it to a negative number or zero for the default avatar id. Otherwise, you need to choose a valid avatar id. |
| projectTypeKey | String | No | Set the project type key. If it is not set, the default value is "business". This function will not work for Service Desk project type. |

## Return Type

**Boolean (true/false)**

Returns 'true' if the project was created and 'false' if not.

## Examples

### Example 1

```
admCreateProject("T3", "Thunderbolt3", "Three thunderbolts in a single hole", "zeus", "http://thunderbolts.olimpus.gr", "PUBLIC", false, 0);
```

### Example 2

```
admCreateProject("T3", "Thunderbolt3", "Three thunderbolts in a single hole", "zeus", "http://thunderbolts.olimpus.gr", "PUBLIC", false, 0, "business");
```

> ⚠️ - Attempts to create a project with the same key or name as an existing project will result in an error
> ⚠️ - Executing user must have permissions to create projects

## See also

> Macro (contentbylabel)