Toggle Sidebar

Incoming Webhooks (Actions)

Send data into TrackingTime in real-time. Incoming webhooks are a simple way to send data into TrackingTime from external sources when a specific event occurrs.

We receive incoming webhooks at following URL:

https://app.trackingtime.co/webhooks/:account_token/:user_token/:webhook_token

You need to send a POST request to that url including the required JSON payload in the body of your request.

Available Events

This is an overview of all available incoming events.

Type Event Description Event Name
Project Add new Project project.add
Close Project project.close
Task Add new Task task.add
Close Task task.close
Start Tracking Task task.tracking.start
Stop Tracking Task task.tracking.stop
Event Add new Event event.add
Update Event event.update



Add New Project

Automatically add a new project.

Payload

{
"name":"A new exciting project",
"client_name": "Acme, Inc.",
"service_name": "Web Design",
"estimated_time": 10,
"delivery_date": 2016-01-20 00:00:00,
"is_billable": true,
"notes": "Some text..."
}

Integrations

Close Project

Automatically close an open project.

Payload

{
"id":12341,
"name":"Optionally a name"
}

Integrations

Add New Task

Automatically add a new task.

Payload

{
"name":"A new task",
"project_name": "An Existing Project",
"estimated_time": 20,
"due_date": 2016-01-20 00:00:00,
"is_billable": true
}

Integrations

Close Task

Automatically close an open task.

Payload

{
"id":1234132,
"name":"Optionally a task name instead"
}

Integrations

Start Tracking Task

Automatically start tracking time on a task when a certain event is triggered by your app or by one of the online services you use.

Payload

{
"id": 123456, 
"date": "2015-12-31 09:00:00", 
"timezone": "GMT-04:00",
"task_name": "A new task", 
"project_name": "Some project", 
"return_task": true,
"stop_running_task":true
}

Integrations

  • Slack: Type in 'track [task] in [project]' in a Slack channel and start tracking time. Learn more
  • HipChat: Type in 'track [task] in [project]' in a HipChat channel and start tracking time. Learn more

Stop Tracking Task

Automatically stop tracking time on a task when a certain event is triggered by your app or by one of the online services you use.

Payload

{
"id": 123456, 
"date": "2015-12-31 09:00:00", 
"timezone": "GMT-04:00",
"task_name": "A new task",  
}

Integrations

Add New Event

Automatically add a new time entry when a certain event is triggered by your app or by one of the online services you use.

Payload

{
"start": "2015-12-31 09:00:00",
"end": "2015-12-31 10:00:00",  
"timezone": "GMT-04:00",
"task_id": 123456789,
"task_name": "An existing task",
"notes": "Some text..."  
}

Integrations