---
title: "Install Natterbox Freedom Connected App: A Quick Guide"
slug: "install-natterbox-freedom-oauth-app"
description: "Follow our straightforward steps to install and configure the Natterbox Freedom connected app, ensuring all users can self-authorize easily."
tags: ["Installation Guide", "Natterbox Freedom", "OAuth Policies"]
updated: 2026-03-13T05:42:20Z
published: 2026-03-13T05:42:20Z
canonical: "docs.natterbox.com/install-natterbox-freedom-oauth-app"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.natterbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to install the Natterbox Freedom Oauth app

## Why install the Natterbox Freedom Oauth app?

Starting in September 2025, Salesforce restricted the use of uninstalled Connected Apps to improve security, requiring that all OAuth-enabled apps be explicitly installed in the org.

If you are using the Natterbox wallboards via the read-only link, you will login using Salesforce to ‘Flightdeck’. If you are getting error messages when trying to login, you might need to check if the steps below have been completed.

Here are some examples of the error messages:

`We can't authorize you because of an OAuth error. For more information, contact your Salesforce administrator. OAUTH_APPROVAL_ERROR_GENERIC: An unexpected error occurred during authentication. Please try again.`

![Salesforce OAuth error message indicating authorization failure and contact information.](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image002 (2).png)

## Setting Up Natterbox Freedom Connected App

This article provides a step-by-step guide to install and configure the Natterbox Freedom connected app in your system. Follow these instructions carefully to ensure proper setup.

### Installation Steps

1. Go to Setup.
2. In the top-left search bar, search for **Connected Apps OAuth Usage** and click on the link that appears.

![](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image(316).png)
3. In the window that opens, find the row containing the **Natterbox Freedom** connected app.
4. On the right side of the row, click **Install**.

![](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image(317).png)

### Configuring OAuth Policies

Once the Natterbox Freedom app is installed, you must configure the OAuth policies to allow user access.

1. After installation, click **Edit Policies**, then click **Edit**.
2. In the **OAuth Policies** section, do the following:
  - Set **Permitted Users** to *All users may self-authorize*.
  - Change **IP Relaxation** from *Enforce IP restrictions* to *Relax IP restrictions*.

![](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image(318).png)
3. Click **Save** to apply the changes.

By following these steps, you will successfully install and configure the Natterbox Freedom connected app, allowing all users to self-authorize with relaxed IP restrictions.

---

### FAQs

#### What is the first step to install the Natterbox Freedom connected app?

Go to Setup and search for Connected Apps OAuth Usage in the top-left search bar.

#### How should the permitted users setting be configured in the OAuth Policies?

Permitted Users should be set to All users may self-authorize.

#### What change needs to be made regarding IP Relaxation in the OAuth Policies?

Change IP Relaxation from Enforce IP restrictions to Relax IP restrictions.