CreateProject

Creates a new project

Request Parameters

Parameter Type Description Required
action string “CreateProject” Required
title string The title of the new project Required
adminid int The adminId the project will be associated with Required
userid int The user that the project is for Optional
status string The status of the project as defined in Project Management Settings Optional
created \Carbon\Carbon The created date of the project in Y-m-d format Optional
duedate \Carbon\Carbon The duedate date of the project in Y-m-d format Optional
completed bool Is the project completed Optional
ticketids string A comma separated list of ticket IDs to associate with the project Optional
invoiceids string A comma separated list of invoice IDs to associate with the project Optional

Response Parameters

Parameter Type Description
result string The result of the operation: success or error
message string ‘Project has been created’

Example Request (CURL)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    http_build_query(
        array(
            'action' => 'CreateProject',
            // See https://developers.whmcs.com/api/authentication
            'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
            'password' => 'SECRET_OR_HASHED_PASSWORD',
            'title' => 'This is a Test Project',
            'adminid' => '2',
            'responsetype' => 'json',
        )
    )
);
$response = curl_exec($ch);
curl_close($ch);

Example Request (Local API)

$command = 'CreateProject';
$postData = array(
    'title' => 'This is a Test Project',
    'adminid' => '2',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later

$results = localAPI($command, $postData, $adminUsername);
print_r($results);

Example Response JSON

{
    "result": "success",
    "message": "Project has been created"
}

Error Responses

Possible error condition responses include:

  • Client ID Not Found
  • Admin ID not Set
  • Admin ID Not Found
  • Project Management is not active.
  • Project Title is Required.

Version History

Version Changelog
1.0 Initial Version