Skip to main content

​
Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/nutshell/filled/png

Connector Profile

Nutshell - API Key
2

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/nutshell/filled/png

Link Account

Nutshell - API Key

​
Configure the webhook in Nutshell

This connector uses Manual Webhooks. You need to add the StackOne webhook URL in your Nutshell account settings so that Nutshell sends events to StackOne.

1

Copy the Native Webhook URL

When linking your Nutshell account in StackOne (or via StackOne Hub), the Native Webhook URL is displayed on the hub form. Copy this URL — you will paste it into Nutshell in the next steps.

2

Open Nutshell webhook settings

Sign in to your Nutshell account and navigate to the webhook settings.

  • Click Settings in the bottom-left corner of the sidebar.
  • Click Connections in the sidebar to open the API Keys page.
  • Scroll down to the Outgoing webhooks section.
3

Add the webhook

Add a new outgoing webhook pointing to the StackOne endpoint.

  • Click Add a webhook…
  • Enter a Name (e.g., “StackOne”).
  • Paste the Native Webhook URL you copied from StackOne into the URL field.
  • Ensure Is active is checked.
  • Click Add webhook to save.
4

Select event subscriptions in the dashboard

In the StackOne dashboard, enable the webhook events you want to receive. See the Available Webhook Events section below for the full list. Nutshell sends all events to the webhook — StackOne filters and routes only the events you have enabled.

5

Unsubscribe

To stop receiving events, either disable the webhook in Nutshell (uncheck Is active) or delete it from the Outgoing webhooks table. You can also disable individual event types in the StackOne dashboard — unmatched events are silently acknowledged.

​
Available Webhook Events

The following Nutshell events can be enabled in StackOne. Nutshell delivers all events to the webhook URL (firehose model); only events enabled in StackOne are forwarded to your downstream consumer.

1

Contact events (People)

Events related to contacts (people) in the CRM.

  • Contact Created (contacts_created) — Fired when a new contact is added
  • Contact Updated (contacts_updated) — Fired when a contact’s attributes change (name, email, phone, custom fields, description, etc.)
  • Contact Deleted (contacts_deleted) — Fired when a contact is deleted
  • Contact Merged (contacts_merged) — Fired when two contacts are merged into one
2

Account events (Companies)

Events related to company accounts.

  • Account Created (accounts_created) — Fired when a new company is added
  • Account Updated (accounts_updated) — Fired when a company’s attributes change (name, industry, custom fields, etc.)
  • Account Deleted (accounts_deleted) — Fired when a company is deleted
  • Account Merged (accounts_merged) — Fired when two companies are merged into one
3

Lead events

Events related to leads (sales opportunities).

  • Lead Created (leads_created) — Fired when a new lead is created
  • Lead Updated (leads_updated) — Fired when a lead’s attributes change (description, value, stage, confidence, outcome, etc.)
  • Lead Deleted (leads_deleted) — Fired when a lead is deleted
  • Lead Merged (leads_merged) — Fired when two leads are merged into one
4

Activity events

Events related to activities (calls, meetings, tasks).

  • Activity Created (activities_created) — Fired when a new activity is scheduled
  • Activity Updated (activities_updated) — Fired when an activity’s details change (name, description, time, etc.)
  • Activity Deleted (activities_deleted) — Fired when an activity is deleted
  • Activity Logged (activities_logged) — Fired when an activity is marked as completed
  • Activity Cancelled (activities_cancelled) — Fired when a scheduled activity is cancelled
5

Assignment events

Events related to owner/assignee changes on contacts, accounts, or leads.

  • Assignment Created (assignments_created) — Fired when an entity is assigned to a user
  • Assignment Updated (assignments_updated) — Fired when an assignment is changed to a different user
  • Assignment Deleted (assignments_deleted) — Fired when an assignment is removed
6

Note events

Events related to notes on contacts, accounts, or leads.

  • Note Created (notes_created) — Fired when a note is added
  • Note Updated (notes_updated) — Fired when a note is edited
  • Note Deleted (notes_deleted) — Fired when a note is deleted
7

File events

Events related to file attachments on contacts, accounts, or leads.

  • File Uploaded (files_created) — Fired when a file is uploaded
  • File Deleted (files_deleted) — Fired when a file is deleted

​
Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.