# Create project

Creates a project.

> Important: If you want to make the project owner a member, you must specify the owner_id body parameter set to that user's ID.

Endpoint: POST /projects
Version: v1
Security: AuthToken

## Header parameters:

  - `Content-Type` (string, required)
    Enum: "application/json"

  - `Accept` (string, required)
    Enum: "application/json"

## Request fields (application/json):

  - `archived` (boolean)
    true if the project is archived; false otherwise.

  - `description` (string)
    Describes the project.
    Example: "Big pool in a small backyard."

  - `name` (string, required)
    Project name.
    Example: "PR001: Example Project"

  - `project_code` (string)
    A code for referencing the project.
    Example: "PR001"

  - `timeentry_lockout` (integer)
    The lockout indicates whether the project locks out new time entries and, if so, the number of days previous that entries are locked.

Valid values:

| Value | Description |
| ------------- | --------------- |
| -1 | Not locked |
| 0 | Locked for all entries |
| Integer greater than or equal to 1. For example, 7. | If 7, for example, then the project is locked for entries more than 7 calendar days older than the date when this value was set. |

Note: We don't support setting this property to a date.

Note: A project's [phases](/api/resource_management/openapi/phases) inherit the project's timeentry_lockout.

  - `ends_at` (string)
    The project's ending date.
    Example: "2025-05-29"

  - `starts_at` (string)
    The project's starting date.
    Example: "2025-01-27"

  - `use_parent_bill_rates` (boolean)
    If true and the project has a parent project, the project uses the parent project's bill rates.

  - `phase_name` (string)
    Name of the phase.

  - `client` (string)
    Client name.
    Example: "Your Client"

  - `project_state` (string)
    Describes the state of the project.
    Enum: "Confirmed", "Tentative", "Internal"

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier for the resource instance.
    Example: 821065

  - `archived` (boolean)
    true if the project is archived; false otherwise.

  - `archived_at` (string)
    Date the project was archived.

  - `description` (string)
    Describes the project.
    Example: "Big pool in a small backyard."

  - `guid` (string)
    Globally Unique Identifier for the resource instance.
    Example: "d9d0de8f-32cc-4c0b-8af1-648ce039e3f6"

  - `name` (string)
    Project name.
    Example: "PR001: Example Project"

  - `parent_id` (integer,null)
    If the object is a Project, this value is null. Otherwise, this value is the ID of the parent project.

  - `project_code` (string)
    A code for referencing the project.
    Example: "PR001"

  - `secureurl` (string)
    A secure URL to the project.
    Example: "https://smartsheet.com/some/path"

  - `secureurl_expiration` (string)
    The date (in UTC) when the secure URL expires.
    Example: "3000-01-01T00:00:00Z"

  - `timeentry_lockout` (integer)
    The lockout indicates whether the project locks out new time entries and, if so, the number of days previous that entries are locked.

Valid values:

| Value | Description |
| ------------- | --------------- |
| -1 | Not locked |
| 0 | Locked for all entries |
| Integer greater than or equal to 1. For example, 7. | If 7, for example, then the project is locked for entries more than 7 calendar days older than the date when this value was set. |

Note: We don't support setting this property to a date.

Note: A project's [phases](/api/resource_management/openapi/phases) inherit the project's timeentry_lockout.

  - `ends_at` (string)
    The project's ending date.
    Example: "2025-05-29"

  - `starts_at` (string)
    The project's starting date.
    Example: "2025-01-27"

  - `deleted_at` (string)
    If set, it's the date and time the project was archived; otherwise, the project is active.

  - `created_at` (string)
    Project creation date.
    Example: "2025-01-22T06:00:30Z"

  - `updated_at` (string)
    Date of the most recent modification.
    Example: "2025-01-22T06:13:40Z"

  - `use_parent_bill_rates` (boolean)
    If true and the project has a parent project, the project uses the parent project's bill rates.

  - `type` (string)
    The object type.
    Example: "Project"

  - `project_state_id` (integer)
    Example: 8544040

  - `thumbnail` (string)
    A thumbnail image for the project.

Note: you can't set a thumbnail for a project via the API -- to add a thumbnail, use the application UI.
    Example: "https://10kftprojectimages.s3.amazonaws.com/a62ffd30-316f-4cb6-9c7f-eca45d07a35d/499af1a7-bc6b-446f-8535-4472e6159246.png"

  - `owner_id` (integer)
    Project owner ID.
    Example: 11223344

  - `owner_name` (string)
    Project owner name.

  - `phase_count` (integer)

  - `phase_name` (string)
    Name of the phase.

  - `has_pending_updates` (boolean)
    true if the project has pending updates; false otherwise.

  - `client` (string)
    Client name.
    Example: "Your Client"

  - `project_state` (string)
    Describes the state of the project.
    Enum: "Confirmed", "Tentative", "Internal"

  - `tags` (object)

  - `tags.paging` (object)

  - `tags.paging.per_page` (integer)
    The maximum number of items to show per response page.
    Example: 100

  - `tags.paging.page` (integer)
    The current response page number.
    Example: 1

  - `tags.paging.previous` (string,null)
    If you're on the first page, this value is null; otherwise the value is the path and query parameters to get the previous page of items.
    Example: "/api/v1/users?per_page=1000&page=1"

  - `tags.paging.self` (string)
    The path and query parameters to get the current page of items.
    Example: "/api/v1/users?per_page=1000&page=2"

  - `tags.paging.next` (string,null)
    If there are more items, this value is the path and query parameters to get the next page of items; otherwise, it's null.
    Example: "/api/v1/users?per_page=1000&page=3"

  - `tags.paging.count` (integer,null)
    The total number of items in all the pages.

  - `tags.data` (array)

  - `tags.data.value` (string, required)
    Tag name.
    Example: "New"

  - `custom_field_values` (object)
    Note: This property is only included in responses if the fields query parameter includes custom_field_values.

  - `bounding_startdate` (string)
    The earliest date (start date or date) across all project-related activities and data, including assignables, expense items, assignments, and time entries. The date may precede the project start date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-01-01"

  - `bounding_enddate` (string)
    The latest date (end date or date) across all project-related activities and data, including assignables, expense items, assignments, and time entries. The date may follow the project end date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-07-01"

  - `bounding_startdate_assignables` (string)
    The earliest start date of all phases (if any) in the project. The date may precede the project start date. If there are no phases, this date is the project start date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-01-01"

  - `bounding_enddate_assignables` (string)
    The latest end date of all phases (if any) in the project. The date may follow the project end date. If there are no phases, this date is the project end date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-07-01"

  - `bounding_startdate_expense_items` (string)
    The earliest date of all expense items (if any) in the project. The date may precede the project start date. 

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-01-01"

  - `bounding_enddate_expense_items` (string)
    The latest date of all expense items (if any) in the project. The date may follow the project end date. 

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-07-01"

  - `bounding_startdate_time_entries` (string)
    The earliest date of all time entries (if any) in the project. The date may precede the project start date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-01-01"

  - `bounding_enddate_time_entries` (string)
    The latest date of all time entries (if any) in the project. The date may follow the project end date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-07-01"

  - `bounding_startdate_assignments` (string)
    The earliest start date a user is assigned to the project. The date may precede the project start date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-01-01"

  - `bounding_enddate_assignments` (string)
    The latest end date a user is assigned to the project. The date may follow the project end date.

Note: This property is only included if the fields query parameter includes bounding_dates or summary.
    Example: "2025-07-01"

  - `children` (object)
    The project phases, if any.

  - `confirmed_hours` (number)
    Example: 1283.600000000003

  - `confirmed_dollars` (number)
    Example: 160450

  - `approved_hours` (integer)

  - `approved_dollars` (number)

  - `unconfirmed_hours` (number)
    Example: 87.60000000000002

  - `unconfirmed_dollars` (number)
    Example: 10950

  - `scheduled_hours` (number)
    Example: 1322.400000000003

  - `scheduled_dollars` (number)
    Example: 165300

  - `future_hours` (integer)

  - `future_dollars` (number)