All Integrations
AlertingNotion API Integration

Notion Integration

Log TigerOps incidents to Notion databases with rich properties, real-time timeline updates, and AI-generated postmortem content. Build a searchable reliability knowledge base in Notion automatically.

Setup

How It Works

01

Create a Notion Integration

In Notion, go to Settings > Connections > Develop or manage integrations and create a new internal integration. Copy the integration token for use in TigerOps.

02

Share Your Database with the Integration

In Notion, open your incident log database, click the three-dot menu, go to Connections, and add your TigerOps integration. TigerOps can now write to this database.

03

Map Database Properties to Incident Fields

In TigerOps, map your Notion database property names (title, select, date, URL fields) to TigerOps incident attributes like severity, service name, start time, and AI summary.

04

Incidents Log to Notion Automatically

TigerOps creates a Notion database page for each incident with all configured properties populated, and updates the page with timeline events and resolution data throughout the lifecycle.

Capabilities

What You Get Out of the Box

Automatic Incident Database Pages

TigerOps creates a structured Notion database page for every qualifying incident, with severity, service, environment, start time, AI summary, and trace link pre-populated.

Rich Property Mapping

Map TigerOps data to any Notion property type: Select (for severity), Multi-Select (for service tags), Date (for timestamps), URL (for trace and dashboard links), and Text.

Timeline Block Updates

During active incidents, TigerOps appends timeline blocks to the Notion page body — investigation steps, runbook actions, and metric observations — building a real-time incident log.

AI Postmortem Content Generation

When an incident resolves, TigerOps appends an AI-generated postmortem section to the Notion page: root cause, timeline summary, contributing factors, and follow-up actions.

Resolution Property Sync

Resolution time, incident duration, and root cause properties are updated on the Notion database page automatically when TigerOps closes the incident.

Reliability Knowledge Base

Over time, TigerOps-populated Notion databases become a searchable reliability knowledge base: filter by service, severity, or date to find past incident patterns and solutions.

Configuration

Notion Database Mapping Config

Map TigerOps incident fields to Notion database properties and configure timeline sync.

notion-integration.yaml
# TigerOps — Notion Integration Config

integrations:
  notion:
    integration_token: "${NOTION_INTEGRATION_TOKEN}"
    database_id: "${NOTION_INCIDENT_DATABASE_ID}"
    min_severity: warning
    sync_timeline: true
    append_postmortem: true

    property_mappings:
      # Property name in Notion : TigerOps template variable
      title:           "{{incident_title}}"
      Severity:        "{{severity}}"          # Select property
      Service:         "{{service_name}}"       # Select property
      Environment:     "{{environment}}"        # Select property
      Status:          "{{incident_status}}"    # Select property
      Started At:      "{{started_at}}"         # Date property
      Resolved At:     "{{resolved_at}}"        # Date property
      Duration:        "{{incident_duration}}"  # Text property
      AI Summary:      "{{ai_summary}}"         # Text property
      Trace URL:       "{{trace_url}}"          # URL property
      TigerOps URL:    "{{tigerops_url}}"       # URL property
      Root Cause:      "{{ai_root_cause}}"      # Text property
      Tags:            "{{service_tags}}"       # Multi-select property

    timeline_block_format: "**{{event_time}}** — {{event_description}}"

    postmortem_section:
      heading: "## AI-Generated Postmortem"
      include_root_cause: true
      include_timeline: true
      include_action_items: true
FAQ

Common Questions

Can TigerOps write to an existing Notion database with custom properties?

Yes. TigerOps maps to your existing Notion database properties by name. As long as your TigerOps integration has access to the database and the property names match your configuration, it will write to your existing schema without creating new properties.

Does TigerOps support Notion workspace-level databases or only page-level databases?

TigerOps writes to Notion databases via the Notion API, which supports both top-level workspace databases and databases embedded within a page. The database just needs to be shared with your TigerOps integration.

Can I use a Notion template for the incident page body?

TigerOps creates the initial page body using its own incident structure template. You can customize the default body template using TigerOps template variables. Full support for pre-existing Notion page templates is on the roadmap.

How does TigerOps handle updates to an incident that is already logged in Notion?

TigerOps stores the Notion page ID when it creates a page. All subsequent updates — timeline blocks, status changes, resolution data — are appended to or update that same Notion page. TigerOps never creates duplicate pages for the same incident.

Is there a limit to how many incidents TigerOps can log to Notion?

Notion does not impose a row limit on database entries beyond general plan storage limits. TigerOps logs one page per incident with no artificial limit. For high-volume alert environments, the min_severity threshold can be raised to log only meaningful incidents.

Get Started

Build Your Reliability Knowledge Base in Notion

No credit card required. Connect Notion in minutes. Incidents log with AI postmortems automatically.