PRproductive
Projects

Create a project

Changed on

Create a project. Creates a new project with the given attributes.

Required: name, project_manager_id, project_type_id, and workflow_id. company_id is required for non-internal project types.

{
  "data": {
    "type": "projects",
    "attributes": {
      "name": "Acme website redesign",
      "project_type_id": 2,
      "project_manager_id": 42,
      "company_id": 999,
      "workflow_id": 7
    }
  }
}

To duplicate an existing project or create one from a template, use /projects/copy instead.

post/api/v2/projects

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/projects
  • Auth
    none declared

Request body

Example request

{
  "data": {
    "type": "projects",
    "attributes": {
      "name": "Website Redesign",
      "description": "Full redesign of the company website",
      "project_color_id": 1
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "65111"
        }
      },
      "project_manager": {
        "data": {
          "type": "people",
          "id": "12"
        }
      },
      "workflow": {
        "data": {
          "type": "workflows",
          "id": "75"
        }
      }
    }
  }
}

Response

Single project

Example response

{
  "data": {
    "id": "6899",
    "type": "projects",
    "attributes": {
      "name": "Website Redesign",
      "number": "12",
      "project_number": "12",
      "project_color_id": 1,
      "preferences": {},
      "last_activity_at": "2026-03-15T10:30:00.000+00:00",
      "archived_at": null,
      "created_at": "2026-01-01T09:00:00.000+00:00",
      "template": false,
      "description": null,
      "custom_fields": null,
      "tag_colors": {}
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "65111"
        }
      },
      "project_manager": {
        "data": {
          "type": "people",
          "id": "12"
        }
      },
      "workflow": {
        "data": {
          "type": "workflows",
          "id": "75"
        }
      }
    }
  },
  "included": []
}

Changes

  • 7dcc2525e812Revision changes
    • warning

      added the new netsuite_project_ambiguous enum value to the // response property for the response status

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status