Testifly logo Testifly logo

Notion Integration

This guide shows how to connect Notion to Testifly with OAuth, what information is saved after the connection succeeds, and how to re-check, reconnect, or remove the saved workspace connection later.

1. Before you connect Notion

Make sure you have:

  • Access to the Testifly project where you want to manage integrations
  • Permission to authorize integrations for the Notion workspace you want to connect
  • A Notion account that can sign in and approve the Testifly authorization flow

Notion is connected in Testifly by using OAuth, so you do not need to create or paste a manual API key in the setup flow.

2. Start the Notion connection in Testifly

  1. Open your project in Testifly.
  2. Go to Site Settings.
  3. Open the Integrations section.
  4. In the Notion card, click Connect Notion.

After you click the button, Testifly redirects you to the Notion authorization screen.

3. Authorize Testifly in Notion

  1. Sign in to Notion if you are prompted.
  2. Review the Notion authorization screen.
  3. Choose the workspace you want to connect, if Notion asks you to select one.
  4. Approve the Testifly connection.
  5. Wait for Notion to redirect you back to Testifly.

When the authorization succeeds, Testifly saves the connected workspace for the current project and returns you to the * *Site Settings -> Integrations** area.

4. Test the saved Notion connection

Use this when you want to confirm that the saved Notion OAuth connection is still valid.

  1. Open your project in Testifly.
  2. Go to Site Settings.
  3. Open Integrations.
  4. In the Notion card, click Test connection.
  5. Wait for Testifly to validate the saved connection.

If the check succeeds, the integration updates the latest health information in the card. If the check fails, Testifly stores the failure result and shows the returned error message.

5. Reconnect the workspace

Use this when you want to connect a different workspace or refresh the authorization by repeating the OAuth flow.

  1. Open your project in Testifly.
  2. Go to Site Settings.
  3. Open Integrations.
  4. In the Notion card, click Reconnect workspace.
  5. Complete the Notion authorization flow again.

After the redirect back to Testifly, the project is updated with the latest connected workspace details.

6. Remove the Notion connection

Use this when you want to disconnect Notion completely from the project.

  1. Open your project in Testifly.
  2. Go to Site Settings.
  3. Open Integrations.
  4. In the Notion card, click Remove.
  5. Confirm the removal when Testifly asks for confirmation.

This removes the saved Notion integration record and the stored OAuth tokens for that project.

7. Troubleshooting

The connection does not complete after I click Connect Notion

Check these items first:

  • You completed the Notion authorization flow instead of closing it early
  • You approved the correct workspace in Notion
  • Your browser allowed the redirect back to Testifly

Test connection fails

Check all of the following:

  • The Notion workspace authorization is still active
  • The saved connection belongs to the workspace you expect
  • The authorized Notion account still has access to that workspace
  • You retry the flow by using Reconnect workspace if the original authorization has expired or been revoked

I want to fully reset the integration

Use Remove first, then run Connect Notion again to create a fresh workspace authorization for the project.

8. Tips for a smoother Notion setup

  • Use a Notion account that is intended for your project integrations so future maintenance is easier
  • Re-run Test connection after reconnecting to confirm the saved workspace is healthy
  • If the saved workspace or account details do not look right, use Reconnect workspace to repeat the authorization flow
  • If you no longer want Testifly to hold the Notion connection for the project, use Remove to delete the saved connection and tokens