Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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)

  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-

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)

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.

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.

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


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

The connection is rejected when I click Connect

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

Members appear, but no dialer activity

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

A rep's calls are missing

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

Activity in Harmony differs from the Nooks Reporting page

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

Rotating the API key
  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.


Data & Privacy

Key privacy principles

For information about how Harmony handles your data, see our Privacy Policy.

  • 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

What Harmony does not collect

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

Last updated

Was this helpful?