Jump to >

This documentation covers Review Board 3.0. You can see the latest Review Board documentation or all other versions.


reviewboard.extensions.hooks.IntegrationHook is used to register new Integrations in Review Board.

Integrations are similar to extensions, but are intended for connecting to third-party services or tools. Each integration can have multiple configurations, making them ideal for cases where different groups or teams may have different requirements. For example, one group may want notifications posted to their chat service while another may not.

Extensions can provide integrations by subclassing reviewboard.integrations.Integration and providing the necessary functions and attributes. See Writing Integrations to learn how to write an integration.

Once you have an integration class, you can use this hook to register it as part of your extension.


from __future__ import unicode_literals

import json
import logging

from django import forms
from django.utils.six.moves.urllib.request import Request, urlopen
from djblets.forms.fields import ConditionsField
from reviewboard.extensions.base import Extension
from reviewboard.extensions.hooks import IntegrationHook, SignalHook
from reviewboard.integrations.forms import IntegrationConfigForm
from reviewboard.integrations.integration import Integration
from reviewboard.reviews.conditions import ReviewRequestConditionChoices

class SampleIntegrationConfigForm(IntegrationConfigForm):
    endpoint_url = forms.CharField(label='Endpoint URL', required=True)
    client_id = forms.CharField(label='Client ID', required=True)
    conditions = ConditionsField(ReviewRequestConditionChoices,

class SampleIntegration(Integration):
    name = 'Sample Integration'
    description = 'This is my special integration that does stuff.'

    default_settings = {
        'endpoint_url': 'https://example.com/endpoint/',
        'client_id': 'abc123',

    config_form_cls = SampleIntegrationConfigForm

    def icon_static_urls(self):
        extension = SampleExtension.instance

        return {
            '1x': extension.get_static_url('images/icon.png'),
            '2x': extension.get_static_url('images/icon@2x.png'),

    def initialize(self):
        SignalHook(self, review_request_published,

    def _on_review_request_published(self, user, review_request,
                                     changedesc, **kwargs):
        for config in self.get_configs(review_request.local_site):
            if not config.match_conditions(form_cls=self.config_form_cls,

                urlopen(Request(config['endpoint_url'], json.dumps({
                    'client_id': config['client_id'],
                    'review_request_id': review_request.display_id,
            except Exception as e:
                logging.exception('Failed to send notification: %s', e)

class SampleExtension(Extension):
    def initialize(self):
        IntegrationHook(self, SampleIntegration)