--- title: "Create a new project" method: POST path: "/api/v3/projects" tags: ["projects"] --- # Create a new project `POST /api/v3/projects` ## Headers - `Fieldwire-Version` string, date, required ## Request body - object - `project` ProjectCreateInput, required — Schema for creating project - `id` string, uuid — ID of the entity - `has_logo` boolean — Boolean if project has logo - `is_email_notifications_enabled` boolean — Whether email notifications are enabled for this project - `prompt_effort_on_complete` boolean — Whether prompt to input effort should be shown on marking tasks as completed - `address` string, nullable — Address of this project - `code` string, nullable — Code of this project - `color` string — Color to use for this project for highlighting in the UI - `currency` string — Currency to use for the `cost_value` of `Task`s in this project - `logo_url` string, nullable — URL of the logo for this project - `man_power_units` string — Unit to use for the `man_power_value` of `Task`s in this project - `name` string, required — Name of this project - `min_verified_at_days` integer — Count of days after which verified tasks are archived - `sheets_limit` integer, nullable — Count of the latest sheet versions that should be cached on the mobile apps - `archived_at` string, date-time, nullable — Time when this project was archived - `device_created_at` string, date-time — Time when the device created the entity - `device_updated_at` string, date-time — Time when the device last updated the entity - `is_plan_email_notifications_enabled` boolean — Whether notifications should be sent out on processing plans - `tz_name` 'Etc/GMT+12' | 'Pacific/Midway' | 'Pacific/Pago_Pago' | 'Pacific/Honolulu' | 'America/Juneau' | 'America/Los_Angeles' | 'America/Tijuana' | 'America/Denver' | 'America/Phoenix' | 'America/Chihuahua' | 'America/Mazatlan' | 'America/Chicago' | 'America/Regina' | 'America/Mexico_City' | 'America/Mexico_City' | 'America/Monterrey' | 'America/Guatemala' | 'America/New_York' | 'America/Indiana/Indianapolis' | 'America/Bogota' | 'America/Lima' | 'America/Lima' | 'America/Halifax' | 'America/Caracas' | 'America/La_Paz' | 'America/Santiago' | 'America/St_Johns' | 'America/Sao_Paulo' | 'America/Argentina/Buenos_Aires' | 'America/Montevideo' | 'America/Guyana' | 'America/Puerto_Rico' | 'America/Godthab' | 'Atlantic/South_Georgia' | 'Atlantic/Azores' | 'Atlantic/Cape_Verde' | 'Europe/Dublin' | 'Europe/London' | 'Europe/Lisbon' | 'Europe/London' | 'Africa/Casablanca' | 'Africa/Monrovia' | 'Etc/UTC' | 'Europe/Belgrade' | 'Europe/Bratislava' | 'Europe/Budapest' | 'Europe/Ljubljana' | 'Europe/Prague' | 'Europe/Sarajevo' | 'Europe/Skopje' | 'Europe/Warsaw' | 'Europe/Zagreb' | 'Europe/Brussels' | 'Europe/Copenhagen' | 'Europe/Madrid' | 'Europe/Paris' | 'Europe/Amsterdam' | 'Europe/Berlin' | 'Europe/Zurich' | 'Europe/Zurich' | 'Europe/Rome' | 'Europe/Stockholm' | 'Europe/Vienna' | 'Africa/Algiers' | 'Europe/Bucharest' | 'Africa/Cairo' | 'Europe/Helsinki' | 'Europe/Kiev' | 'Europe/Riga' | 'Europe/Sofia' | 'Europe/Tallinn' | 'Europe/Vilnius' | 'Europe/Athens' | 'Europe/Istanbul' | 'Europe/Minsk' | 'Asia/Jerusalem' | 'Africa/Harare' | 'Africa/Johannesburg' | 'Europe/Kaliningrad' | 'Europe/Moscow' | 'Europe/Moscow' | 'Europe/Volgograd' | 'Europe/Samara' | 'Asia/Kuwait' | 'Asia/Riyadh' | 'Africa/Nairobi' | 'Asia/Baghdad' | 'Asia/Tehran' | 'Asia/Muscat' | 'Asia/Muscat' | 'Asia/Baku' | 'Asia/Tbilisi' | 'Asia/Yerevan' | 'Asia/Kabul' | 'Asia/Yekaterinburg' | 'Asia/Karachi' | 'Asia/Karachi' | 'Asia/Tashkent' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kathmandu' | 'Asia/Dhaka' | 'Asia/Colombo' | 'Asia/Almaty' | 'Asia/Almaty' | 'Asia/Novosibirsk' | 'Asia/Rangoon' | 'Asia/Bangkok' | 'Asia/Bangkok' | 'Asia/Jakarta' | 'Asia/Krasnoyarsk' | 'Asia/Shanghai' | 'Asia/Chongqing' | 'Asia/Hong_Kong' | 'Asia/Urumqi' | 'Asia/Kuala_Lumpur' | 'Asia/Singapore' | 'Asia/Taipei' | 'Australia/Perth' | 'Asia/Irkutsk' | 'Asia/Ulaanbaatar' | 'Asia/Seoul' | 'Asia/Tokyo' | 'Asia/Tokyo' | 'Asia/Tokyo' | 'Asia/Yakutsk' | 'Australia/Darwin' | 'Australia/Adelaide' | 'Australia/Canberra' | 'Australia/Melbourne' | 'Australia/Sydney' | 'Australia/Brisbane' | 'Australia/Hobart' | 'Asia/Vladivostok' | 'Pacific/Guam' | 'Pacific/Port_Moresby' | 'Asia/Magadan' | 'Asia/Srednekolymsk' | 'Pacific/Guadalcanal' | 'Pacific/Noumea' | 'Pacific/Fiji' | 'Asia/Kamchatka' | 'Pacific/Majuro' | 'Pacific/Auckland' | 'Pacific/Auckland' | 'Pacific/Tongatapu' | 'Pacific/Fakaofo' | 'Pacific/Chatham' | 'Pacific/Apia', nullable — Timezone of this project - `measurement_units` 'imperial' | 'metric' — Unit to use for the measurements show on plans - `box_token_user_id` integer — ID of a user who has an active valid Box token, to be used for this newly created project - `dropbox_token_user_id` integer — ID of a user who has an active valid Dropbox token, to be used for this newly created project - `source` ProjectCreateSourceInput, nullable — Schema for source input - `project_template_id` string, uuid, nullable — ID of the project template to generate a project from ## Response `201` Successful response - ProjectWithUser — Entity that carries project & some user related information - `id` string, uuid, required — ID of the entity - `account_id` integer, required — Account id project is under - `has_logo` boolean, required — Boolean if project has logo - `is_3d_bim_enabled` boolean, nullable — If 3D BIM is enabled for this project - `is_mobile_location_creation_enabled` boolean, nullable — If location creation on mobile is enabled for this project - `is_email_notifications_enabled` boolean, required — Whether email notifications are enabled for this project - `is_plan_text_search_enabled` boolean — Whether plan text search is enabled for this project - `prompt_effort_on_complete` boolean, required — Whether prompt to input effort should be shown on marking tasks as completed - `address` string, nullable — Address of this project - `code` string, nullable — Code of this project - `color` string, required — Color to use for this project for highlighting in the UI - `currency` string, required — Currency to use for the `cost_value` of `Task`s in this project - `default_pm_group_id` string, uuid, nullable — The default PmGroup for this project, if it is a PM-enabled project - `logo_url` string, nullable — URL of the logo for this project - `man_power_units` string, required — Unit to use for the `man_power_value` of `Task`s in this project - `name` string, required — Name of this project - `time_zone` string, required — Timezone of this project - `min_verified_at_days` integer — Count of days after which verified tasks are archived - `sheets_limit` integer, nullable — Count of the latest sheet versions that should be cached on the mobile apps - `owner_email` string, nullable — Email of user who owns the project - `plan_name` 'Basic' | 'Pro' | 'Business' | 'Enterprise' — Tier this project belongs to - `is_premium` boolean, required — If this is a premium project - `is_enterprise` boolean, required — If this project is an enterprise project - `work_week` boolean[], nullable — Array of seven boolean values indicating whether Sunday-Saturday are work days - `archived_at` string, date-time, nullable — Time when this project was archived - `created_at` string, date-time, required — Time when the server created the entity - `device_created_at` string, date-time, required — Time when the device created the entity - `resolved_conflict` boolean, required — Specifies if PUT/PATCH request was rejected - do not store this field! - `device_updated_at` string, date-time, required — Time when the device last updated the entity - `updated_at` string, date-time, required — Time when the server last updated the entity - `deleted_at` string, date-time, nullable — Time the server deleted the entity - `is_analytics_enabled` boolean — Whether analytics is enabled for this project - `is_forms_enabled` boolean — Whether `Forms` tab should be shown for this project - `is_photo_attachments_enabled` boolean — Whether `Photos` tab should be shown for this project - `is_plan_email_notifications_enabled` boolean — Whether notifications should be sent out on processing plans - `is_tasks_enabled` boolean — Whether `Tasks` tab should be shown for this project - `tz_name` 'Etc/GMT+12' | 'Pacific/Midway' | 'Pacific/Pago_Pago' | 'Pacific/Honolulu' | 'America/Juneau' | 'America/Los_Angeles' | 'America/Tijuana' | 'America/Denver' | 'America/Phoenix' | 'America/Chihuahua' | 'America/Mazatlan' | 'America/Chicago' | 'America/Regina' | 'America/Mexico_City' | 'America/Mexico_City' | 'America/Monterrey' | 'America/Guatemala' | 'America/New_York' | 'America/Indiana/Indianapolis' | 'America/Bogota' | 'America/Lima' | 'America/Lima' | 'America/Halifax' | 'America/Caracas' | 'America/La_Paz' | 'America/Santiago' | 'America/St_Johns' | 'America/Sao_Paulo' | 'America/Argentina/Buenos_Aires' | 'America/Montevideo' | 'America/Guyana' | 'America/Puerto_Rico' | 'America/Godthab' | 'Atlantic/South_Georgia' | 'Atlantic/Azores' | 'Atlantic/Cape_Verde' | 'Europe/Dublin' | 'Europe/London' | 'Europe/Lisbon' | 'Europe/London' | 'Africa/Casablanca' | 'Africa/Monrovia' | 'Etc/UTC' | 'Europe/Belgrade' | 'Europe/Bratislava' | 'Europe/Budapest' | 'Europe/Ljubljana' | 'Europe/Prague' | 'Europe/Sarajevo' | 'Europe/Skopje' | 'Europe/Warsaw' | 'Europe/Zagreb' | 'Europe/Brussels' | 'Europe/Copenhagen' | 'Europe/Madrid' | 'Europe/Paris' | 'Europe/Amsterdam' | 'Europe/Berlin' | 'Europe/Zurich' | 'Europe/Zurich' | 'Europe/Rome' | 'Europe/Stockholm' | 'Europe/Vienna' | 'Africa/Algiers' | 'Europe/Bucharest' | 'Africa/Cairo' | 'Europe/Helsinki' | 'Europe/Kiev' | 'Europe/Riga' | 'Europe/Sofia' | 'Europe/Tallinn' | 'Europe/Vilnius' | 'Europe/Athens' | 'Europe/Istanbul' | 'Europe/Minsk' | 'Asia/Jerusalem' | 'Africa/Harare' | 'Africa/Johannesburg' | 'Europe/Kaliningrad' | 'Europe/Moscow' | 'Europe/Moscow' | 'Europe/Volgograd' | 'Europe/Samara' | 'Asia/Kuwait' | 'Asia/Riyadh' | 'Africa/Nairobi' | 'Asia/Baghdad' | 'Asia/Tehran' | 'Asia/Muscat' | 'Asia/Muscat' | 'Asia/Baku' | 'Asia/Tbilisi' | 'Asia/Yerevan' | 'Asia/Kabul' | 'Asia/Yekaterinburg' | 'Asia/Karachi' | 'Asia/Karachi' | 'Asia/Tashkent' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kolkata' | 'Asia/Kathmandu' | 'Asia/Dhaka' | 'Asia/Colombo' | 'Asia/Almaty' | 'Asia/Almaty' | 'Asia/Novosibirsk' | 'Asia/Rangoon' | 'Asia/Bangkok' | 'Asia/Bangkok' | 'Asia/Jakarta' | 'Asia/Krasnoyarsk' | 'Asia/Shanghai' | 'Asia/Chongqing' | 'Asia/Hong_Kong' | 'Asia/Urumqi' | 'Asia/Kuala_Lumpur' | 'Asia/Singapore' | 'Asia/Taipei' | 'Australia/Perth' | 'Asia/Irkutsk' | 'Asia/Ulaanbaatar' | 'Asia/Seoul' | 'Asia/Tokyo' | 'Asia/Tokyo' | 'Asia/Tokyo' | 'Asia/Yakutsk' | 'Australia/Darwin' | 'Australia/Adelaide' | 'Australia/Canberra' | 'Australia/Melbourne' | 'Australia/Sydney' | 'Australia/Brisbane' | 'Australia/Hobart' | 'Asia/Vladivostok' | 'Pacific/Guam' | 'Pacific/Port_Moresby' | 'Asia/Magadan' | 'Asia/Srednekolymsk' | 'Pacific/Guadalcanal' | 'Pacific/Noumea' | 'Pacific/Fiji' | 'Asia/Kamchatka' | 'Pacific/Majuro' | 'Pacific/Auckland' | 'Pacific/Auckland' | 'Pacific/Tongatapu' | 'Pacific/Fakaofo' | 'Pacific/Chatham' | 'Pacific/Apia', nullable — Timezone of this project - `measurement_units` 'imperial' | 'metric' — Unit to use for the measurements show on plans - `trial_end_at` string, date-time, nullable — Time when the trial for this project ends - `is_task_status_enabled` boolean, nullable — Whether this project can have custom task statuses (denoted by `Status`) - `min_api_version` string, date, nullable — Minimum Fieldwire API version required to use this project - `pm_group_id` string, uuid, nullable — Id of PM Group for user of this project - `is_project_labels_enabled` boolean — Whether Project Labels should be shown for this project - `project_attributes` object[], nullable — Set of serialized project_attributes for this project - `id` string, uuid, required — ID of the entity - `creator_user_id` integer, required — ID of the user who created this entity - `last_editor_user_id` integer, required — ID of the user who most recently edited this entity - `account_id` integer, required — ID of the account this entity belongs to - `resolved_conflict` boolean, required — Specifies if PUT/PATCH request was rejected - do not store this field! - `created_at` string, date-time, required — Time when the server created the entity - `updated_at` string, date-time, required — Time when the server last updated the entity - `device_created_at` string, date-time, required — Time when the device created the entity - `device_updated_at` string, date-time, required — Time when the device last updated the entity - `deleted_at` string, date-time, nullable, required — Time the server deleted the entity - `name` string, required — Name of the project attribute, must be unique. - `color` string, required — Color of the project attribute - `kind` 'label' | 'priority', required — Kind of project attribute ## Other responses - `403` — Returns forbidden when user is not allowed to make projects --- [API](https://skmtc.net/fieldwire/apis/fieldwire-super-api.md) · [All operations](https://skmtc.net/fieldwire/apis/fieldwire-super-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fieldwire/fieldwire-super-api/versions/66ee1c20b92d/schema)