Adds a new project. Full access to Teamwork is required.


  • workflow POST

    Array of IDs of the statuses, which must be available for processing tasks within the project, listed in the order in which the statuses must be sorted.

  • name POST

    Project name.

  • color POST Optional

    Color name to highlight tasks belonging to the project: 't-white', 't-gray', 't-yellow', 't-green', 't-blue', 't-red', 't-purple'.

  • icon_url POST Optional

    Project logo URL.

  • icon_hash POST Optional

    Hash of a project logo file uploaded using the “tasks.attachments.add” method to be used if the “icon_url” parameter is not completed.

  • sort POST Optional

    Sort value for the project list (integer).

  • format GET Optional

    Sets response format. Available options: json (default), xml.

Return value

Array with the following keys:

  • id int Project ID.
  • name string Project name.
  • sort int Sort value.
  • color string Color name to highlight tasks.
  • create_datetime string Project creation date and time in the ISO 8601 format.
  • icon string Logo URL.