Upsource 2017.3 Help

Upsource webhooks

Upsource webhooks allow you to notify external services, such as an issue tracker, a CI server, or a deployment tool, about events that occur in an Upsource project. Webhooks are a way to push notifications to external services which is usually preferable to polling. When an event occurs inside Upsource we'll send a JSON payload to specified URLs using HTTP POST. The following events are available:

  • a comment is added
  • a review is created
  • reviewed changes are accepted by a reviewer / a concern is raised about the changes
  • a new participant is added to a review
  • a review participant is removed
  • a review closed or reopened
  • a revision is added to a review
  • a new revision is detected
  • a new branch is detected
  • a merge is made to the default branch

To set up a webhook:

  1. Click the settings icon Settings on the top right of the screen. The Administration view will open.
  2. Locate the project you want to set up a webhook for and click Edit project next to its name.
  3. In the right pane, under Settings, click Webhooks. You'll be redirected to the Webhooks setup page.
    webhooks_form
  4. Check Enable webhooks.
  5. Click Add trigger. In the displayed form, select one or more triggering events and specify URLs of the services you want to be notified.
  6. Click Save changes.
Last modified: 28 February 2018