Skip to main content
Nutshell
Nutshell
75 actions · 26 events · 1 auth method
CRM

Authentication

API Key

Use your Nutshell email and API key for Basic Authentication.Guides: Connector Profile, Link Account
Actions
75 actions
Action
Description
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
Events
|
26 events
Event
Description
Tags
Active Check
Responds to Nutshell’s ping request with a 200 OK to confirm the webhook endpoint is active.
Health Check
Contact Created
Emitted when a new contact (person) is created. Maps to Nutshell event where payloadType is contacts and action is `cr…
Contacts
Contact Updated
Emitted when a contact’s attributes are changed (name, address, phone, custom fields, owner, description, etc.). Maps to…
Contacts
Contact Deleted
Emitted when a contact is deleted. Maps to Nutshell event where payloadType is contacts and action is delete.
Contacts
Account Created
Emitted when a new company (account) is created. Maps to Nutshell event where payloadType is accounts and action is `c…
Accounts
Account Updated
Emitted when a company’s attributes are changed (name, address, industry, custom fields, owner, description, etc.). Maps…
Accounts
Account Deleted
Emitted when a company (account) is deleted. Maps to Nutshell event where payloadType is accounts and action is `delet…
Accounts
Lead Created
Emitted when a new lead is created. Maps to Nutshell event where payloadType is leads and action is create.
Leads
Lead Updated
Emitted when a lead’s attributes change (description, due time, confidence, stage, value, products, etc.). Maps to Nutsh…
Leads
Lead Deleted
Emitted when a lead is deleted. Maps to Nutshell event where payloadType is leads and action is delete.
Leads
Activity Created
Emitted when a new activity is created. Maps to Nutshell event where payloadType is activities and action is create.
Activities
Activity Updated
Emitted when an activity’s details change (name, description, time, status). Maps to Nutshell event where payloadType is…
Activities
Activity Deleted
Emitted when an activity is deleted. Maps to Nutshell event where payloadType is activities and action is delete.
Activities
Activity Logged
Emitted when an activity is logged (marked as completed). Maps to Nutshell event where payloadType is activities and a…
Activities
Activity Cancelled
Emitted when a scheduled activity is cancelled. Maps to Nutshell event where payloadType is activities and action is `…
Activities
Assignment Created
Emitted when a contact, lead, or account is assigned to a user. Maps to Nutshell event where payloadType is `assignments…
Assignments
Assignment Updated
Emitted when an assignment is updated (reassigned to a different user). Maps to Nutshell event where payloadType is `ass…
Assignments
Assignment Deleted
Emitted when an assignment is removed. Maps to Nutshell event where payloadType is assignments and action is delete.
Assignments
Note Created
Emitted when a note is added to a contact, account, or lead. Maps to Nutshell event where payloadType is notes and act…
Notes
Note Updated
Emitted when a note is edited. Maps to Nutshell event where payloadType is notes and action is update.
Notes
Note Deleted
Emitted when a note is deleted. Maps to Nutshell event where payloadType is notes and action is delete.
Notes
Contact Merged
Emitted when two contacts are merged into one. The changes array contains the merged_with_id. Maps to Nutshell event whe…
Contacts
Account Merged
Emitted when two companies (accounts) are merged into one. Maps to Nutshell event where payloadType is accounts and ac…
Accounts
Lead Merged
Emitted when two leads are merged into one. Maps to Nutshell event where payloadType is leads and action is merge.
Leads
File Uploaded
Emitted when a file is uploaded to a contact, account, or lead. Maps to Nutshell event where payloadType is files and…
Files
File Deleted
Emitted when a file is deleted from a contact, account, or lead. Maps to Nutshell event where payloadType is files and…
Files

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See the Projects Guide.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.

Connector Profile

Nutshell - API Key
3

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Nutshell - API Key
4

Use Actions

Invoke actions using one of the methods below:

Webhook Events

Webhooks setup

Configure receiving Events for Nutshell into StackOne.