Webhooks Overview

Webhooks lets you easily develop push notifications. This push notification is simply a HTTP POST, that is triggered by some action in your Teamwork Projects account.

This is a feature aimed for developers who want to get data from actions (like when a new task is added or a milestone is edited) that occur on their Teamwork Projects account.

You could use Webhooks to:

  • Perform an action in a 3rd party app based on some item being completed in Teamwork Projects (e.g: When a task is completed, update a SVN client)
  • Extend Teamwork Projects using your own app where a feature is required but not part of Teamwork Projects (e.g: Send an email notification to a certain person when a task is added to your Teamwork Projects account)
  • Record who downloaded a particular file and when
  • Add Job Numbers to the start of a Project or Task when they are created. e.g: [JN10001] My new project
  • When time is logged in Teamwork Projects update an internal Dashboard of information
  • Cut down on the amount of polling of the API you need to do to see if something has changed
  • Use the FILE.CREATED event to trigger a script to download a Teamwork Projects file right in to your Dropbox/Box folder
  • etc

A couple of notes on Webhooks

  • Webhooks are only available on paid plans.
  • Callbacks are notified when these events occur from within the Teamwork Projects application or from another application that uses the Teamwork Projects API.
  • Webhooks will automatically be deactivated if three or more events get discarded (ie: A status code other than 200 was returned after 3 tries).

Getting help on Webhooks

While the webhooks implementation is very straight forward, we're always here to help. If you have any questions or need some guidance just drop us a line to api@teamwork.com