Nooks access token connector for AI agents

Tools your sales agent reaches for on Nooks, scoped per user.

CALL ANY TOOL

20 tools for sales engagement in Nooks: read accounts, prospects, calls, emails, sequences, and tasks, then enroll prospects, add notes, and manage tasks.

nooksapikey_account_get

Get account

Get one Nooks account (company) by its ID. Returns the account's name, domain, CRM IDs, owner, and optionally its CRM custom fields. Use nooksapikey_account_get when you have the ID. Use nooksapikey_accounts_list to search by name, domain, or CRM ID.

Parameters

Name

Type

Required

Description

string

Required

Nooks ID (UUID) of the account. Get it from nooksapikey_accounts_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

include_crm_custom_fields

boolean

Optional

Set to true to add each record's CRM custom fields as crmCustomFields, keyed by CRM field name (for example {"hs_lead_status": "OPEN"}).

nooksapikey_accounts_list

List accounts

nooksapikey_call_dispositions_list

List call dispositions

nooksapikey_call_get

Get call

nooksapikey_calls_list

List calls

List calls made in Nooks, filtered by call time, ingestion time, prospect, account, disposition, or caller. Returns up to 100 calls per page with time, duration, direction, disposition, prospect, and owner, plus a links.next cursor. Use nooksapikey_calls_list to find calls. Use nooksapikey_call_get for one call by ID.

Parameters

Name

Type

Required

Description

account_id

string

Optional

Only return calls linked to this account. Use the account's Nooks ID (UUID) from nooksapikey_accounts_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

created_after

string

Optional

Only return calls ingested into Nooks at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

created_before

string

Optional

Only return calls ingested into Nooks at or before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

disposition_id

string

Optional

Only return calls logged with this disposition. Use the disposition's Nooks ID (UUID) from nooksapikey_call_dispositions_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

filter_ids

string

Optional

Only return calls with these Nooks IDs, comma-separated. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

include

string

Optional

Related records to embed in the response instead of returning only their IDs (max 3). Pass one or more of these values, comma-separated: prospect, sequence, sequenceStep, callDisposition, owner. Example: prospect,sequence.

owner_id

string

Optional

Only return calls placed by this user. Use the user's Nooks ID from nooksapikey_users_list or nooksapikey_me_get. Example: Xk3pQ9rT2vLmN8sA1bC4dE5fG6h7.

page_after

string

Optional

Cursor for the next page. Pass the page[after] value from the links.next URL of the previous response, unchanged. Leave empty for the first page.

page_size

integer

Optional

Number of calls to return per page (1 to 100). Defaults to 50.

prospect_id

string

Optional

Only return calls with this prospect. Use the prospect's Nooks ID (UUID) from nooksapikey_prospects_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

time_after

string

Optional

Only return calls that happened at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

time_before

string

Optional

Only return calls that happened at or before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

updated_after

string

Optional

Only return calls updated at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

updated_before

string

Optional

Only return calls updated before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

nooksapikey_email_get

Get email

nooksapikey_emails_list

List emails

nooksapikey_me_get

Get me

nooksapikey_prospect_get

Get prospect

nooksapikey_prospect_note_create

Create prospect note

nooksapikey_prospects_list

List prospects

List prospects in Nooks, filtered by IDs, exact name or title, email, CRM ID, sequence, account, or update time. Returns up to 100 prospects per page with contact details, account reference, and owner, plus a links.next cursor. Use nooksapikey_prospects_list to find prospects. Use nooksapikey_prospect_get when you already have the prospect ID.

Parameters

Name

Type

Required

Description

account_id

string

Optional

Only return prospects at this account. Use the account's Nooks ID (UUID) from nooksapikey_accounts_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

filter_crm_id

string

Optional

Only return the prospect with this ID in your CRM. Example: 0035g00000XyZabAAB.

filter_emails

string

Optional

Only return prospects whose primary email is one of these addresses, comma-separated (up to 10). Example: jane@acme.com,john@acme.com.

filter_ids

string

Optional

Only return prospects with these Nooks IDs, comma-separated. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

filter_name

string

Optional

Only return prospects with this exact full name. Example: Jane Doe.

filter_title

string

Optional

Only return prospects with this exact job title. Example: VP of Sales.

include

string

Optional

Related records to embed in the response instead of returning only their IDs (max 3). Pass one or more of these values, comma-separated: sequenceStates. Example: sequenceStates.

include_crm_custom_fields

boolean

Optional

Set to true to add each record's CRM custom fields as crmCustomFields, keyed by CRM field name (for example {"hs_lead_status": "OPEN"}).

page_after

string

Optional

Cursor for the next page. Pass the page[after] value from the links.next URL of the previous response, unchanged. Leave empty for the first page.

page_size

integer

Optional

Number of prospects to return per page (1 to 100). Defaults to 50.

sequence_id

string

Optional

Only return prospects enrolled in this sequence. Use the sequence's Nooks ID (UUID) from nooksapikey_sequences_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

updated_after

string

Optional

Only return prospects updated at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

updated_before

string

Optional

Only return prospects updated at or before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

nooksapikey_sequence_get

Get sequence

nooksapikey_sequence_state_create

Create sequence state

nooksapikey_sequence_states_list

List sequence states

nooksapikey_sequences_list

List sequences

nooksapikey_task_complete

Complete task

nooksapikey_task_create

Create task

nooksapikey_task_get

Get task

nooksapikey_tasks_list

List tasks

List outreach tasks in Nooks, filtered by sequence, step, prospect, account, owner, action, status, priority, due date, or completion. Returns up to 100 tasks per page with action, status, priority, due date, prospect, and owner, plus a links.next cursor. Use nooksapikey_tasks_list to build a rep's to-do list. Use nooksapikey_task_get for one task by ID.

Parameters

Name

Type

Required

Description

account_id

string

Optional

Only return tasks for prospects at this account. Use the account's Nooks ID (UUID) from nooksapikey_accounts_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

action

string

Optional

Only return tasks of these action types. Pass one or more of these values, comma-separated: call, manual_email, auto_email, manual_email_reply, auto_email_reply, basic_task, linkedin_connection_request, manual_linkedin_connection_request, manual_linkedin_message, automatic_linkedin_message, manual_sms, auto_sms. Example: call,manual_email.

completed

boolean

Optional

Set to true for completed tasks only, or false for open tasks only.

due_after

string

Optional

Only return tasks due at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

due_before

string

Optional

Only return tasks due at or before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

enrollment_state

string

Optional

Only return tasks whose sequence enrollment is in these states. Use null for one-off tasks that are not part of a sequence. Pass one or more of these values, comma-separated: active, paused, finished, null. Example: active.

filter_ids

string

Optional

Only return tasks with these Nooks IDs, comma-separated. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

include

string

Optional

Related records to embed in the response instead of returning only their IDs (max 3). Pass one or more of these values, comma-separated: owner, prospect, sequence, sequenceState, sequenceStep. Example: owner,prospect.

owner_id

string

Optional

Only return tasks assigned to this user. Use the user's Nooks ID from nooksapikey_users_list or nooksapikey_me_get. Example: Xk3pQ9rT2vLmN8sA1bC4dE5fG6h7.

page_after

string

Optional

Cursor for the next page. Pass the page[after] value from the links.next URL of the previous response, unchanged. Leave empty for the first page.

page_size

integer

Optional

Number of tasks to return per page (1 to 100). Defaults to 50.

priority

string

Optional

Only return tasks with these priorities. Pass one or more of these values, comma-separated: low, normal, high, urgent. Example: high,urgent.

prospect_id

string

Optional

Only return tasks for this prospect. Use the prospect's Nooks ID (UUID) from nooksapikey_prospects_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

sequence_id

string

Optional

Only return tasks in this sequence. Use the sequence's Nooks ID (UUID) from nooksapikey_sequences_list. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

sequence_step_id

string

Optional

Only return tasks for this sequence step. Example: 3f2b8c1e-4d5a-4b6c-9e7f-1a2b3c4d5e6f.

status

string

Optional

Only return tasks in these statuses. Pass one or more of these values, comma-separated: pending, ready, finished, skipped, failed. Example: ready.

updated_after

string

Optional

Only return tasks updated at or after this time. Use an ISO 8601 date-time, for example 2024-01-01T00:00:00Z.

updated_before

string

Optional

Only return tasks updated before this time. Use an ISO 8601 date-time, for example 2024-12-31T23:59:59Z.

nooksapikey_users_list

List users

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Nooks (API Key) tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["nooksapikey"], toolNames: [
    "nooksapikey_prospects_list",
    "nooksapikey_calls_list",
    "nooksapikey_sequence_state_create"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "List my calls from yesterday that ended with a meeting booked" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["nooksapikey"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "List my calls from yesterday that ended with a meeting booked" }],
  tools,
});

// Execute the tool call with the user's vaulted Nooks access token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["nooksapikey"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "List my calls from yesterday that ended with a meeting booked" }],
  tools,
});

// Tool call runs with the user's vaulted Nooks access token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["nooksapikey"] }, pageSize: 100,
});

const agent = new Agent({
  name: "sales_agent",
  model: "gemini-2.5-pro",
  instruction: "Nooks (API Key) tools scoped to this user",
  tools,
});

await agent.run("List my calls from yesterday that ended with a meeting booked");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Nooks tool. Click to copy, paste into your agent, done.

Prospects and accounts

Copy the prompt

Copied

Find the prospect with email jordan@acme.com and show their account.

Copy the prompt

Copied

List prospects at globex.com and their sequence enrollments.

Copy the prompt

Copied

Add a note to this prospect: asked for pricing after the demo.

Calls and emails

Copy the prompt

Copied

List my calls from yesterday with the Meeting Booked disposition.

Copy the prompt

Copied

Show emails sent to prospects at Acme this week.

Copy the prompt

Copied

List the call dispositions configured in our workspace.

Sequences and tasks

Copy the prompt

Copied

Enroll this prospect in the Q4 Outbound sequence starting Monday.

Copy the prompt

Copied

List my open tasks due today with high priority.

Copy the prompt

Copied

Mark the call task for Jordan Lee as completed.

SEE HOW AUTH WORKS

Each user connects their own Nooks access token once; Scalekit sends it with every call. Tokens stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

Nooks (API Key)

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Nooks (API Key)

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Nooks (API Key)

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Nooks (API Key)

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other sales engagement connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

Sales call prep agent

Reads tomorrow's calls from Google Calendar, mines past Granola notes and Attio history for context, and delivers each rep a prep brief in Slack, scoped to the calls that rep actually owns.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

GTM and RevOps Teams

Deal intelligence agent

Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Nooks access token looks fine in a demo. In production every sequence enrollment looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Nooks today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Nooks as the user or through a shared key?

As the user. Each user connects their own Nooks access token once, and Scalekit sends it with every call. Audit logs attribute every enrollment, note, and task to that user, not a shared service account.

Where is each user's Nooks access token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new access token. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Nooks?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the 16 read tools without nooksapikey_sequence_state_create. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Nooks access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

How is this different from the Nooks OAuth connector?

This connector takes a Nooks access token: each user connects their own token once, and Scalekit sends it with every call. The separate Nooks OAuth connector (nooks) has the same 20 tools, with users signing in instead. Pick this one when your users already work with Nooks access tokens.

On this page

Tool and actions Framework Compatibility Starter Prompt Auth Lifecycle Try Other Agents Why Scalekit