search
Start your 14-day free trial ↗Contact sales

Notion

Baz's Notion Integration

Connect Baz to your Notion workspace to allow Baz to read ticket data directly from your Notion database. This enables richer PR context, improved spec validation, and more accurate review insights.

Baz uses this context to:

  • Enrich AI-generated summaries and topics with your business objectives.

  • Tailor prompts to reflect the goals and constraints from the Notion ticket.

  • Help reviewers focus on what’s important by aligning code changes to the original intent.

Configure Notion integration

hashtag
Configuring Baz & Notion

Step 1: Create a Notion Internal Integration

  1. Go to Notion’s internal integrations pagearrow-up-right.

  2. Create a New Integration:

    1. Click “New integration”

    2. Select the Notion workspace that contains your ticketing system

  3. Grant the integration the required capabilities - read access is required for Baz to consume ticket data.

  4. Copy the internal integration secret:

    1. Copy the Internal Integration Secret

    2. This is your API token, you will paste this into Baz in the next step

  5. Grant the integration access to your ticket database

    Option A (recommended): From the Integration Settings

    1. Go to the Content access tab

    2. Select the relevant page or database that contains your ticketing system

    Option B: From the Database Page

    1. Navigate to the relevant database page in Notion

    2. Click Share

    3. Add your new created integration

    4. Confirm access

    Once completed, the integration can access your ticket data.

Step 2: Configure Notion in Baz

  1. Go to Baz → Integrations → Notion

  2. Fill in the following fields:

    1. API Token

      Paste the Internal Integration Secret you copied from Notion.

    2. Database URL

      Copy the full URL of your Notion ticket database directly from your browser and paste it here.

    3. ID Property Name

      The name of the property (column) in your Notion database that represents the ticket ID.

      Common default: ID

    4. Issue Type Property Name (Optional)

      If your tickets include a type field (e.g., Bug, Feature, Task), provide the name of that property here.

      Example: Type

    5. Files Property Name (Optional)

      If you attach files to tickets using a database property, provide the name of that property here.

      Example: file

    Click Save in Baz to complete the integration.

    Baz will now be able to read ticket data from your Notion database and use it to enrich PR context and review flows.

Tip: Baz detects relevant Notion tickets when the PR title contains a ticket pattern in the format ABC-123, where ABC is any uppercase prefix and 123 is the issue ID.

hashtag
How Baz Uses Notion Data

When connected, Baz pulls:

  • Story title and description - used to shape review summaries and reasoning.

  • Story type (feature, chore, bug) - helps set reviewer expectations.

  • Acceptance criteria - injected into review prompts to guide validation.

  • Comments and discussion threads - used to enrich reviewer understanding.

This context flows through all downstream Baz workflows:

  • Summaries reflect the purpose of the story.

  • Break down topics based on feature or flow relevance.

  • Guide reviewers to evaluate changes through the lens of what the ticket was designed to accomplish.

PreviousFiberyNextFigma

Last updated