Nutshell

Live 75 Actions 26 Events

Nutshell Integration for AI Agents

Connect your AI agent to 75 Nutshell actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in, plus 26 events to subscribe to.

Start Free Book Demo Nutshell MCP Server

Nutshell AI Agent Actions

75 production-ready actions for your agent to do more on Nutshell.

Read the Nutshell docs

75 Actions

List Users - Retrieve a list of all users in the Nutshell account

Get User - Retrieve a specific user by their ID

List Contacts - Retrieve a paginated list of contacts in Nutshell

List Contact Items - Retrieve all contacts in a list item format with additional filtering and sorting fields

Get Contact - Retrieve a specific contact by their ID

Create Contact - Create a new contact (person) in Nutshell

Update Contact - Update an existing contact by ID using JSON Patch operations

Delete Contact - Delete a contact from Nutshell

Undelete Contact - Restore a previously deleted contact by their ID

List Contact Fields - Retrieve the list of fields available for contacts

List Contact Custom Field Attributes - Retrieve all contact custom field definitions in the Nutshell instance

Get Contact Custom Fields - Retrieve custom field values for a specific contact

Create Contact Custom Field - Create a new custom field definition for contacts

List Accounts - Retrieve a paginated list of accounts in Nutshell

List Account Items - Retrieve all accounts in a list item format with additional filtering and sorting fields

Get Account - Retrieve a specific account by its ID

Create Account - Create a new account (company) in Nutshell

Update Account - Update an existing account by ID using JSON Patch operations

Delete Account - Delete an account from Nutshell

Undelete Account - Restore a previously deleted account by its ID

List Account Fields - Retrieve the list of fields available for accounts

List Account Types - Retrieve all account types in the Nutshell instance

List Industries - Retrieve the list of valid industries in Nutshell

List Account Custom Field Attributes - Retrieve all account custom field definitions in the Nutshell instance

Get Account Custom Fields - Retrieve custom field values for a specific account

Create Account Custom Field - Create a new custom field definition for accounts

List Leads - Retrieve a paginated list of leads in Nutshell

List Lead Items - Retrieve all leads in a list item format with additional filtering and sorting fields

Get Lead - Retrieve a specific lead by its ID

Create Lead - Create a new lead (sales opportunity) in Nutshell

Update Lead - Update an existing lead by ID using JSON Patch operations

Delete Lead - Delete a lead from Nutshell

Undelete Lead - Restore a previously deleted lead by its ID

Update Lead Status - Update the status of a lead including outcome, competitors, and products

Set Lead Pipeline - Assign a lead to a pipeline (stageset)

Reopen Lead - Reopen a previously closed lead

Watch Lead - Toggle notifications for a lead

Get Lead Stages - Retrieve the stage progression data for a specific lead

Get Leads Report - Generate a report for leads with customizable filtering and grouping

List Lead Fields - Retrieve the list of fields available for leads

List Lead Custom Field Attributes - Retrieve all lead custom field definitions in the Nutshell instance

Get Lead Custom Fields - Retrieve custom field values for a specific lead

Create Lead Custom Field - Create a new custom field definition for leads

List Outcomes - Retrieve a list of all lead outcomes in Nutshell

Get Outcome - Retrieve a specific lead outcome by its ID

List Activities - Retrieve a list of activities in Nutshell

Get Activity - Retrieve a specific activity by its ID

Create Activity - Create a new activity in Nutshell

Update Activity - Update an existing activity by its ID

List Activity Types - Retrieve all available activity types in Nutshell

List Tasks - Retrieve a paginated list of tasks in Nutshell

Get Task - Retrieve a specific task by its ID

Create Task - Create a new task in Nutshell

Update Task - Update an existing task by ID using JSON Patch operations

Delete Task - Delete a task from Nutshell

List Notes - Retrieve a paginated list of notes in Nutshell

Get Note - Retrieve a specific note by its ID

Create Note - Create a new note in Nutshell

Delete Note - Delete a note from Nutshell

Undelete Note - Restore a previously deleted note by its ID

List Tags - Retrieve a list of all tags in the Nutshell instance

Create Tag - Create a new tag in Nutshell

Delete Tag - Delete one or more tags from Nutshell

Undelete Tag - Restore a previously deleted tag by its ID

List Sources - Retrieve a list of lead sources in Nutshell

Create Source - Create a new lead source in Nutshell

Delete Source - Delete a lead source from Nutshell

Undelete Source - Restore a previously deleted lead source by its ID

List Products - Retrieve a list of products in Nutshell

Get Product - Retrieve a specific product by its ID

Delete Product - Delete a product from Nutshell

Undelete Product - Restore a previously deleted product by its ID

List Product Categories - Retrieve all product categories in Nutshell

Get Product Category - Retrieve a specific product category by its ID

Create Product Category - Create a new product category in Nutshell

Nutshell Webhook Events

26 real-time Nutshell events your AI agent can subscribe to.

Webhooks for AI agents Read the Nutshell docs

26 Events

Active Check Responds to Nutshell's ping request with a 200 OK to confirm the webhook endpoint is active.
Contact Created Emitted when a new contact (person) is created. Maps to Nutshell event where payloadType is `contacts` and action is `create`.
Contact Updated Emitted when a contact's attributes are changed (name, address, phone, custom fields, owner, description, etc.). Maps to Nutshell event where payloadType is `contacts` and action is `update`.
Contact Deleted Emitted when a contact is deleted. Maps to Nutshell event where payloadType is `contacts` and action is `delete`.
Account Created Emitted when a new company (account) is created. Maps to Nutshell event where payloadType is `accounts` and action is `create`.
Account Updated Emitted when a company's attributes are changed (name, address, industry, custom fields, owner, description, etc.). Maps to Nutshell event where payloadType is `accounts` and action is `update`.
Account Deleted Emitted when a company (account) is deleted. Maps to Nutshell event where payloadType is `accounts` and action is `delete`.
Lead Created Emitted when a new lead is created. Maps to Nutshell event where payloadType is `leads` and action is `create`.
Lead Updated Emitted when a lead's attributes change (description, due time, confidence, stage, value, products, etc.). Maps to Nutshell event where payloadType is `leads` and action is `update`.
Lead Deleted Emitted when a lead is deleted. Maps to Nutshell event where payloadType is `leads` and action is `delete`.
Activity Created Emitted when a new activity is created. Maps to Nutshell event where payloadType is `activities` and action is `create`.
Activity Updated Emitted when an activity's details change (name, description, time, status). Maps to Nutshell event where payloadType is `activities` and action is `update`.
Activity Deleted Emitted when an activity is deleted. Maps to Nutshell event where payloadType is `activities` and action is `delete`.
Activity Logged Emitted when an activity is logged (marked as completed). Maps to Nutshell event where payloadType is `activities` and action is `log`.
Activity Cancelled Emitted when a scheduled activity is cancelled. Maps to Nutshell event where payloadType is `activities` and action is `cancel`.
Assignment Created Emitted when a contact, lead, or account is assigned to a user. Maps to Nutshell event where payloadType is `assignments` and action is `create`.
Assignment Updated Emitted when an assignment is updated (reassigned to a different user). Maps to Nutshell event where payloadType is `assignments` and action is `update`.
Assignment Deleted Emitted when an assignment is removed. Maps to Nutshell event where payloadType is `assignments` and action is `delete`.
Note Created Emitted when a note is added to a contact, account, or lead. Maps to Nutshell event where payloadType is `notes` and action is `create`.
Note Updated Emitted when a note is edited. Maps to Nutshell event where payloadType is `notes` and action is `update`.
Note Deleted Emitted when a note is deleted. Maps to Nutshell event where payloadType is `notes` and action is `delete`.
Contact Merged Emitted when two contacts are merged into one. The changes array contains the merged_with_id. Maps to Nutshell event where payloadType is `contacts` and action is `merge`.
Account Merged Emitted when two companies (accounts) are merged into one. Maps to Nutshell event where payloadType is `accounts` and action is `merge`.
Lead Merged Emitted when two leads are merged into one. Maps to Nutshell event where payloadType is `leads` and action is `merge`.
File Uploaded Emitted when a file is uploaded to a contact, account, or lead. Maps to Nutshell event where payloadType is `files` and action is `create`.
File Deleted Emitted when a file is deleted from a contact, account, or lead. Maps to Nutshell event where payloadType is `files` and action is `delete`.

Nutshell AI Agent Use Cases

Connect your AI agent to Nutshell and help your team scale the sales operations they run by hand today.

Post-Demo Follow-Up

Use StackOne to connect your AI agent to your CRM, email, and calendar tools to automate post-demo follow-up.

View

Deal Risk Scoring

Use StackOne to connect your AI agent to your CRM, email, and calendar tools to automate deal risk scoring and pipeline alerts.

View

Outbound Prospecting

Use StackOne to connect your AI agent to your CRM, sales engagement, and messaging tools to automate outbound prospecting.

View

More Sales & CRM use cases

Do More, Build Less

Integration Infrastructure for Nutshell AI Agents

Multiple Interfaces

Access integrations via API, AI SDKs, MCP & A2A.

Nutshell MCP server

Managed Authentication

Pre-built authentication UI.

Agent auth

Falcon Engine

Every Nutshell action runs on Falcon.

Agent Execution Engine

StackOne Defender

88.7% prompt injection detection.

Prompt injection defense

Start Free Book a Demo

"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."

Luna Schmid, Partner at GV

"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."