Skip to content

7eggs/node-toggl-api

Repository files navigation

toggl-api

Toggl API for Node.js. Library is based on official Toggl API documentation.

Installation

npm install toggl-api --save

How to use

var TogglClient = require('toggl-api');
var toggl = new TogglClient({apiToken: '1971800d4d82861d8f2c1651fea4d212'});

toggl.startTimeEntry({
  description: 'Some cool work',
  billable:    true
}, function(err, timeEntry) {
  // handle error

  // working 10 seconds
  setTimeout(function() {
    toggl.stopTimeEntry(timeEntry.id, function(err) {
      // handle error

      toggl.updateTimeEntry(timeEntry.id, {tags: ['finished']}, function(err) {
        toggl.destroy()
      });
    });
  }, 120000);
});

Documentation

Documentation is available at: http://7eggs.github.io/node-toggl-api/

TODO

  • TESTS
  • Update argument quantity logic on all calls
  • Documentation in Markdown format
  • Remove custom data validator
  • v9 migration
    • add support for new endpoints:
      • /workspaces/{workspace_id}/clients/{client_id}/archive
      • /workspaces/{workspace_id}/clients/{client_id}/restore
      • /organizations/{organization_id}/invitations/{invitation_code}/resend
      • /organizations/invitations/{invitation_code}/accept
      • /organizations/invitations/{invitation_code}/reject