tasks.projects.add

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

HTTP method

POST

Content type

application/x-www-form-urlencoded

Parameters

  • 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.