Create Time Entry (Authenticated User)

Generate a new time entry in your ConstructionOnline company account for the authenticated user making the API request.

 https://api.constructiononline.com/api/TimeData?TimeInfo={info}

This endpoint allows the authenticated user to create a new time entry in their ConstructionOnline company account. If successful, the endpoint will return a record of the newly created purchase order. The new purchase order will be automatically assigned a unique name called 'name', which will be used for any future references. The required field for this endpoint is 'startTime', all other properties are optional and can be entered during time entry creation.

• Requests
• Responses

Requests

Info: JSON

• Properties to be added to the time entry.
• Required property for the time entry: startTime
• Allowed properties for the time entry: projectId, costCode, startNote, endTime

Sample URL request:

• https://api.constructiononline.com/api/TimeData?TimeInfo={"startTime":"2025-03-25T12:00:00","endTime":"2025-03-25T17:00:00"}

Example requests in cURL, C#, Python, and JavaScript can be found below:

cURL

# replace {email} with the email address for your ConstructionOnline account
# {password} with your ConstructionOnline password
# {apikey} with your provided API key
# {info} with time entry properties

curl -X POST https://api.constructiononline.com/api/TimeData?TimeInfo={info} -u {email}:{password} -H 'APIKey:{apikey}'

C#

/* replace {username} with the email address for your ConstructionOnline account
           {password} with your ConstructionOnline password
           {apikey} with your provided API key 
           {info} with time entry properties */

public string MakeRequest(string endpoint, string payload) {
     string username = {username};
     string password = {password};
     string apiKey = {apikey};
     string response = "";
      var handler = new HttpClientHandler() { AutomaticDecompression = System.Net.DecompressionMethods.GZip };
          using (HttpClient client = new HttpClient(handler)) {
           client.BaseAddress = new Uri("http://api.constructiononline.com");
           client.DefaultRequestHeaders.Accept.Clear();
           client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
           client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", System.Convert.ToBase64String(System.Text.Encoding.GetEncoding("ISO-8859-1").GetBytes(username + ":" + password)));
           client.DefaultRequestHeaders.Add("APIKey", apiKey);
           client.DefaultRequestHeaders.Add("Accept-Encoding", "gzip");
           HttpContent content = new StringContent(payload, System.Text.Encoding.UTF32, "application/json");
           response = client.PostAsync(endpoint, content).Result.ToString();
            }
      return response;
            }

     MakeRequest("api/TimeData?TimeInfo={info}"));

Python

#replace {username} with the email address for your ConstructionOnline account
#{password} with your ConstructionOnline password
#{apikey} with your provided API key
#{info} with time entry properties

import base64, requests, json
#Global Variables
  apikey = {apikey}
  username = {username}
  password = {password}

#Functions
  def makeRequest(endpoint, payload):
       url = "https://api.constructiononline.com/" + endpoint
       userPass = username + ":" + password    
       headers = {
                    "APIKey": apikey,
                    "Accept-Encoding": "gzip, deflate, br",
                    "Authorization": "Basic " + base64.b64encode(userPass.encode()).decode(),
                }
       response = requests.request("POST", url, headers=headers, data=payload)
       return json.dumps(json.loads(response.text), indent=2)   

#Main Program 
print(makeRequest("api/TimeData?TimeInfo={info}"))

JavaScript

/* replace {username} with the email address for your ConstructionOnline account
           {password} with your ConstructionOnline password
           {apikey} with your provided API key 
           {info} with time entry properties */

 username = '{username}';
 password = '{password}';
 apikey = '{apikey}';

 function makeRequest(endpoint, payload) {
          auth = btoa('${username}:${password}');
          var myHeaders = new Headers();
          myHeaders.append("APIKey", apikey);
          myHeaders.append("Accept-Encoding", "gzip, deflate, br");
          myHeaders.append("Authorization", "Basic ${auth}");

                var requestOptions = {
                    method: 'POST',
                    body: '',
                    headers: myHeaders,
                    redirect: 'follow'
                };
                fetch("https://api.constructiononline.com/" + endpoint, requestOptions)
                    .then(response => response.text())
                    .then(result => console.log(result))
                    .catch(error => console.log('error', error));
                return response;
            };
 makeRequest("api/TimeData?TimeInfo={info}");

Responses

 200: Success

A successful request will return a 200 response with a record of the newly created time entry in the body.

 404: Error

The server was not able to locate the resource specified in the request. 

 429: Error

The user has surpassed the request rate limit for the hour, day, week, or month.

  500: Error

There was an internal server error and the server was unable to complete the request.

Last updated: April 14, 2025