Developer Resources

API / (POST) Create Time Entry

This API call creates a time entry and returns it.
HTTP-, API- or Beetil-specific errors will be returned otherwise.

API URL
https://youraccount.beetil.com/external_api/v1/time_entries.format
HTTP Method
POST




URL parameters

ParameterFormatDefaultMandatory
selected_user_idUser id to create a time entry for.integerauthenticated userNo




POST parameters

ParameterFormatDefaultMandatory
entrystringYes
hoursintegerYes
descriptionstringNo
performed_atDate the time entry was performedstringNo


These parameters are encapsulated into a 'time_entry' parameter. See the examples below.





Points of Interest
  • For time against a beetil enter:  "B#1234"
  • For other time against a service enter:  "Service Name // Task Description"
  • For non-service related time enter:  "// Task Description"




Example POST
{
  "time_entry": {
    "entry": "B#1234",
    "description": "foo bar",
    "hours": "1"
  }
}




Example POST Response
{
  "result": {
    "time_entry": "JSON string similar to GET time_entries/:id"
  },
  "version": "1.0",
  "status": "Success"
}




Example Error
{
  "errors": [
    {
      "error": "[E400] hours can't be blank"
    }
  ],
  "version": "1.0",
  "status": "Failed"
}




Last updated 31 January 2011