Upsource 2020.1 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 reaction to a comment is added or removed

  • a review is created

  • a review closed or reopened

  • a review is removed

  • 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 revision is added to a review

  • a new revision is detected

  • a new branch is detected

  • an existing branch is deleted

  • 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.


  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: 02 April 2021