Notion integration guide

Notion is a versatile workspace tool that combines notes, documents, knowledge bases, project management, and databases into a single, highly customizable platform. It is widely used by teams for documentation, planning, and coordinating work across an organization.

If your team uses Notion to document new features, projects, or initiatives, the TerraTrue integration ensures that your privacy reviews are automatically initiated at the right time, minimizing manual steps and keeping your privacy program seamlessly connected to your product development process.

How does the TerraTrue-Notion integration work?

The TerraTrue-Notion integration creates a direct and automated connection between your Notion pages and TerraTrue launches. The primary goal is to allow your product and engineering teams to trigger a privacy review launch directly from a Notion page.

What are some things I can do with the Notion integration?

• Automatically trigger launches from Notion databases. Initiate a TerraTrue launch and begin a privacy review immediately when a specific property on a Notion page is set.

• Synchronize core information. The new launch will automatically inherit the Notion page's title, rich-text content (as the launch description), and attachments.

• Identify the launch creator. The owner of the Notion page is automatically assigned as the creator of the new TerraTrue launch.

• Enable AI-powered suggestions. Attachments (like design documents or specs) transferred from Notion to TerraTrue can be used as context for AI-powered suggestions in your launch workflows, speeding up completion and review.

• Keep your Notion page updated. Receive automatic comments on the associated Notion page for key launch lifecycle events (e.g., when the launch is created, updated, or completed).

Setting Up the Notion Integration

Setting up the TerraTrue-Notion integration requires actions in both TerraTrue and Notion.

Step 1: Connect TerraTrue and Notion

You will need an Internal Integration Secret created by a Notion administrator to complete this step.

1. Create a new Integration in Notion.
   1.  Navigate to your Notion integration portal: https://www.notion.so/profile/integrations
   2. Click New Integration and provide a name (recommended: "TerraTrue Integration").
       
2. Generate the API Key in Notion.
    

3. Grant Required Capabilities. To enable TerraTrue to interact with your Notion workspace, ensure the following Content, Comment, and User Capabilities are granted to the integration:
   • Under Content Capabilities, ensure at least “Read content” is allowed.
   • Under Comment capabilities, ensure both “Read comments” and “Insert comments” are allowed.
   • Under Use Capabilities, allow “Read user information including email addresses”.
      
4. Click Submit and copy the resulting Internal Integration Secret.

5. Under “Access” for the “TerraTrue Integration” you just created in Notion, add the appropriate Teamspace that you want to allow the integration to access.
   
    
6. Activate the Integration in TerraTrue:
   1. Log in to TerraTrue and navigate to Org Settings > Integrations > Notion.
   2. Enter the Internal Integration Secret copied from Notion.
   3. Configure the optional settings.  Using the checkboxes for comment synchronization, you can select which launch lifecycle events (e.g., Launch Created, Launch Completed, Status Change) should automatically post a comment back to the linked Notion page.
   4. Click Connect.

Step 2: Configure Notion Database Properties

For TerraTrue to create a launch, the Notion automation needs to be triggered by an action in a database. You will need to define at least two properties in your Notion database:

1. Launch Trigger Property: A property that, when set, triggers an automation to call TerraTrue. Example: Create a Checkbox property named "Ready for TerraTrue". Checking this box will initiate the launch.

2. Review Link Property: An external link property with the token "TerraTrue" in its name. This allows TerraTrue to write the link to the created launch back to the Notion page for easy navigation. Example: Create a URL property named "TerraTrue Review Link".

Step 3: Define the Notion Automation Webhook

Once the integration is active in TerraTrue, the final step is to set up a Notion automation to send the page data to TerraTrue when the trigger property is set.

1. Get the Webhook URL from TerraTrue.
2. On the TerraTrue Notion Integration page, a Webhook URL will be displayed once the connection is successful. Copy this URL.
3. Create the Automation in Notion.
   1. In your desired Notion database, create an Automation.
   2. Trigger: Set the trigger to activate when the Launch Trigger Property (e.g., "Ready for TerraTrue") is set to checked.
   3. Action: Select the Send a custom request action.
   4. URL: Paste the Webhook URL copied from TerraTrue.
   5. Method: Select POST.
   6. Body: Choose Database page.
   7. Authorization: The webhook uses the Authorization header containing the API key you provided in Step 1.

Once this automation is active, checking the "Ready for TerraTrue" box on any page in that database will automatically send the page contents and trigger a new launch creation in TerraTrue.

Beta Release Note

This integration is currently released as a beta feature. We welcome any feedback, suggestions, or issues you encounter as you use the TerraTrue-Notion integration. Your input will be instrumental in developing and refining the integration further.