> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/nooks.md).

# Nooks

Discover the reps who hold a Nooks seat, and track calls dialed and talk time per rep from the Nooks Dialer

Nooks is an AI parallel dialer and virtual salesfloor for sales teams. The Nooks integration connects your Nooks workspace to Harmony, giving your team visibility into who holds a Nooks seat and how much each rep dials, so reps who stopped dialing stand out. Nooks appears as a managed application in Application Management.

#### What the Nooks integration enables

| Capability              | Description                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------ |
| User Discovery          | Surface every member of your Nooks workspace who holds an active seat                |
| Dialer Activity         | Track the calls each rep dials and their talk time, per day, from the Nooks Dialer   |
| Inactive Seats          | See which reps have not dialed recently, using each rep's most recent day of dialing |
| Multi-Workspace Support | Connect several Nooks workspaces, each as its own instance                           |

***

#### Prerequisites

1. **Access to Developer Settings in Nooks** - you need to be able to open **Developer Settings** > **API Keys** in the Nooks workspace you want to connect. This is usually a workspace admin
2. **The Nooks Dialer** - for dialer activity. Without it, Harmony still syncs your workspace's members, but not calls (see [Troubleshooting](#troubleshooting))
3. **A Harmony account** with admin privileges

***

#### Connect Nooks to Harmony

**Step 1: Create a Nooks API key**

1. Sign in to your Nooks workspace
2. Go to **Developer Settings** > **API Keys**
3. Create a new API key and give it a descriptive name (for example, `Harmony Integration`)
4. **Copy the key right away.** Nooks shows it only once. It starts with `nooks-api-`

{% hint style="warning" %}
**A Nooks API key has full access to its workspace.** Nooks API keys cannot be limited to read-only access. Harmony only reads with the key (see [Permissions Explained](#permissions-explained)), but store and revoke it as you would any admin credential.
{% endhint %}

**Step 2: Navigate to Integrations**

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Nooks** under **SaaS Applications**, or search for it by name
4. Click its card. If a Nooks workspace is already connected, click **+ Create instance**

**Step 3: Enter Credentials**

1. **Instance name** (required) - for example the name of the Nooks workspace
2. **API key** - the key you copied in Step 1
3. Click **Connect**

When you click **Connect**, Harmony asks Nooks which workspace the key belongs to before saving. If Nooks rejects the key, the connection is refused with the reason. If Nooks is busy or does not answer, the connection is also refused; try again in a few minutes.

Once connected, Harmony begins syncing members and dialer activity from your Nooks workspace. To connect another workspace, open the Nooks card again, click **+ Create instance**, and repeat Step 3 with an API key from that workspace.

***

#### Disconnect Nooks from Harmony

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Nooks** under **SaaS Applications** and click its card
4. Click the delete (trash) icon next to the instance you want to remove
5. Confirm when prompted

Once disconnected, Harmony stops syncing data from Nooks. Previously synced data remains available in Harmony. You can also revoke the API key in Nooks under **Developer Settings** > **API Keys**.

***

#### What Harmony Syncs from Nooks

| Data         | Description                                                                                                                                                                                   |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Members      | Nooks user ID, name, email address and CRM user ID of every member with an active seat. Every listed member is recorded as active                                                             |
| Calls dialed | The outgoing calls each rep placed through the Nooks Dialer in parallel, power or one-off dialing, per day                                                                                    |
| Talk time    | The seconds of a rep's dialed calls that a person answered. Calls answered by voicemail, a phone tree or a machine are not counted                                                            |
| Other calls  | Incoming calls, outgoing calls logged in Nooks from another dialer, and calls with no recorded direction, each with their talk time, per rep per day. These show as activity only (see below) |

{% hint style="info" %}
**What counts as using a seat.** Calls a rep dials, and their talk time, count as use of the seat and set the rep's last activity. Other calls also appear in the rep's activity, but they do not set last activity or count the rep as active: a prospect can call a rep whether or not the rep is using Nooks, and calls logged from another dialer were not made in Nooks.
{% endhint %}

{% hint style="info" %}
**No roles, seat tiers or login data.** Nooks' API does not expose them. Roles (User, Manager, Admin) and seat types (such as Power Dialer or Parallel Dialer) exist only in Nooks' Seat Management and SCIM provisioning, so every member appears in Harmony with the **member** role and no license tier. Nooks has no login or session history either, so dialer activity is the only usage signal.
{% endhint %}

{% hint style="warning" %}
**Reps who do not use the Dialer look idle.** Harmony's usage data comes from the Nooks Dialer. A member who only uses Salesfloor, Sequencing or AI Coaching has no dialer calls, so they appear in Harmony with no activity.
{% endhint %}

{% hint style="info" %}
**Sync cadence:**

* **Members** refresh every 6 hours
* **Dialer activity** is collected every hour, one full UTC day at a time. Harmony reads a day only after the next UTC day has ended, because Nooks can report calls late, so activity lands one to two days behind
* **Days are UTC days.** A rep's evening calls in the Americas are counted on the next UTC day
* On the first sync, Harmony backfills the last **90 days** of dialer activity
  {% endhint %}

***

#### Viewing Nooks Data in Harmony

* **Application Management** - Nooks appears as a managed application, where you can review its member list and each rep's calls dialed, talk time and last activity
* **User profiles** - individual users show their Nooks access alongside other application data
* **Multiple workspaces** - each connected workspace appears as its own Nooks instance

***

#### Permissions Explained

Harmony reads Nooks through its Partner API (`partner-api.nooks.in`), authenticated with the API key you provide. All access is read-only.

| What Harmony calls     | Why                                                                            |
| ---------------------- | ------------------------------------------------------------------------------ |
| `GET /v1/me`           | Identify the workspace the key belongs to                                      |
| `GET /v1/users`        | Workspace members with an active seat, and the emails that match calls to reps |
| `GET /v1/dialer/calls` | Calls placed through the Nooks Dialer, totalled per rep per day                |

Things to know about the key:

* **The key cannot be scoped.** A Nooks API key has full read and write access to its workspace. Harmony only reads: it does not add or remove members, place calls, or change anything in Nooks or your CRM
* **Harmony shares your rate limit.** Nooks allows 300 requests a minute on each of `/v1/users` and `/v1/dialer/calls`, and 30 a minute on `/v1/me`, per workspace across all of your keys. Harmony makes at most two requests a second, leaving most of that for your other tools

***

#### Troubleshooting

<details>

<summary>The connection is rejected when I click Connect</summary>

**Possible causes:**

* The key was mistyped, or extra spaces or characters were copied with it
* The key was revoked in Nooks
* Nooks was busy or unreachable when Harmony checked the key

**Solutions:**

1. Create a new key under **Developer Settings** > **API Keys** in Nooks, copy it right away, and paste it into Harmony
2. If the key is correct, try again in a few minutes

</details>

<details>

<summary>Members appear, but no dialer activity</summary>

**Possible causes:**

* Your Nooks workspace does not have the Nooks Dialer. Members sync for every workspace, but calls are available only with the Dialer
* Activity has not arrived yet. Harmony collects a day only after the next UTC day has ended, so the first activity appears one to two days after you connect
* The reps use Salesfloor, Sequencing or AI Coaching without the Dialer

**Solutions:**

1. Wait two days after connecting
2. Confirm with Nooks that your workspace has Dialer seats or an active Dialer trial
3. You don't need to reconnect after adding the Dialer. Harmony checks for it every hour, and once it's there, collects the last 90 days of dialer activity
4. If Nooks refuses Harmony's access for any other reason, Harmony keeps retrying with longer and longer gaps. Once the problem is fixed, click **Replace** next to **API key** on the Nooks instance, paste the key (the same key or a new one), and click **Save changes** to restart the sync right away

</details>

<details>

<summary>A rep's calls are missing</summary>

**Possible causes:**

* The rep no longer holds a seat in Nooks. Harmony matches calls to reps through the member list, so calls by a rep who lost their seat cannot be attributed
* The call has no rep in Nooks

**Solutions:**

1. Check the rep's seat in Nooks' Seat Management
2. If a rep with an active seat is still missing activity two days later, contact Harmony Support

</details>

<details>

<summary>Activity in Harmony differs from the Nooks Reporting page</summary>

**Possible causes:**

* Harmony counts calls by UTC day, which may not match the day boundaries the Reporting page uses
* Harmony's talk time counts only calls a person answered
* The most recent one to two days have not been collected yet

**Solutions:**

1. Compare totals over a full week or longer rather than a single day
2. Use Nooks' Reporting page for live, same-day numbers

</details>

<details>

<summary>Rotating the API key</summary>

1. Create a new API key in Nooks under **Developer Settings** > **API Keys**
2. In Harmony, open the Nooks integration card, click **Replace** next to **API key** on the instance, paste the new key and click **Save changes**. Harmony checks that the new key belongs to the same Nooks workspace and refuses a key from a different one
3. Revoke the old key in Nooks

To move the integration to a different Nooks workspace, delete the instance and connect again with that workspace's key.

</details>

***

#### Data & Privacy

<details>

<summary>Key privacy principles</summary>

For information about how Harmony handles your data, see our [Privacy Policy](https://harmony.io/privacy).

* Harmony accesses Nooks data in read-only mode and does not modify anything in your Nooks workspace or your CRM
* Harmony keeps per-rep daily totals, not individual calls
* The integration can be revoked at any time by disconnecting it in Harmony or revoking the API key in Nooks

</details>

<details>

<summary>What Harmony does not collect</summary>

Harmony reads only workspace membership and call totals. It does not collect:

* Call recordings, transcripts or AI summaries
* Phone numbers, prospects, accounts or call dispositions
* Sequences, tasks or CRM records
* IP addresses or login history - Nooks exposes neither

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/saas-applications/nooks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
