> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nutshell Webhook Setup Guide

> Configure Nutshell to deliver events to StackOne.

## Prerequisites

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

<Steps>
  <Step title="Configure the Connector">
    Enable the connector and set up its connector profile in your project. See <a href="/guides/explore-connectors">Managing Connectors</a>.

    <Columns cols={2}>
      <Card title="Connector Profile" href="/connectors/nutshell/guides/connector-profile/api-key" icon="https://stackone-logos.com/api/nutshell/filled/png" horizontal>
        Nutshell - API Key
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Connect an account using <a href="/guides/embedding-stackone-hub">StackOne Hub</a> or <a href="/guides/auth-link">Auth Link</a>.

    <Columns cols={2}>
      <Card title="Link Account" href="/connectors/nutshell/guides/link-account/api-key" icon="https://stackone-logos.com/api/nutshell/filled/png" horizontal>
        Nutshell - API Key
      </Card>
    </Columns>
  </Step>
</Steps>

<section data-guide-section data-guide-scopes="">
  <h2>Configure the webhook in Nutshell</h2>

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

  <Steps>
    <Step title="Copy the Native Webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>When linking your Nutshell account in StackOne (or via StackOne Hub), the <strong>Native Webhook URL</strong> is displayed on the hub form. Copy this URL — you will paste it into Nutshell in the next steps.</p>
      </div>
    </Step>

    <Step title="Open Nutshell webhook settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://app.nutshell.com" target="_blank" rel="noopener noreferrer">Nutshell account</a> and navigate to the webhook settings.</p>

        <ul>
          <li>Click <strong>Settings</strong> in the bottom-left corner of the sidebar.</li>
          <li>Click <strong>Connections</strong> in the sidebar to open the API Keys page.</li>
          <li>Scroll down to the <strong>Outgoing webhooks</strong> section.</li>
        </ul>
      </div>
    </Step>

    <Step title="Add the webhook">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Add a new outgoing webhook pointing to the StackOne endpoint.</p>

        <ul>
          <li>Click <strong>Add a webhook...</strong></li>
          <li>Enter a <strong>Name</strong> (e.g., "StackOne").</li>
          <li>Paste the <strong>Native Webhook URL</strong> you copied from StackOne into the <strong>URL</strong> field.</li>
          <li>Ensure <strong>Is active</strong> is checked.</li>
          <li>Click <strong>Add webhook</strong> to save.</li>
        </ul>
      </div>
    </Step>

    <Step title="Select event subscriptions in the dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the StackOne dashboard, enable the webhook events you want to receive. See the <strong>Available Webhook Events</strong> section below for the full list. Nutshell sends all events to the webhook — StackOne filters and routes only the events you have enabled.</p>
      </div>
    </Step>

    <Step title="Unsubscribe">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>To stop receiving events, either disable the webhook in Nutshell (uncheck <strong>Is active</strong>) or delete it from the Outgoing webhooks table. You can also disable individual event types in the StackOne dashboard — unmatched events are silently acknowledged.</p>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available Webhook Events</h2>

  <p>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.</p>

  <Steps>
    <Step title="Contact events (People)">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to contacts (people) in the CRM.</p>

        <ul>
          <li><strong>Contact Created</strong> (`contacts_created`) — Fired when a new contact is added</li>
          <li><strong>Contact Updated</strong> (`contacts_updated`) — Fired when a contact's attributes change (name, email, phone, custom fields, description, etc.)</li>
          <li><strong>Contact Deleted</strong> (`contacts_deleted`) — Fired when a contact is deleted</li>
          <li><strong>Contact Merged</strong> (`contacts_merged`) — Fired when two contacts are merged into one</li>
        </ul>
      </div>
    </Step>

    <Step title="Account events (Companies)">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to company accounts.</p>

        <ul>
          <li><strong>Account Created</strong> (`accounts_created`) — Fired when a new company is added</li>
          <li><strong>Account Updated</strong> (`accounts_updated`) — Fired when a company's attributes change (name, industry, custom fields, etc.)</li>
          <li><strong>Account Deleted</strong> (`accounts_deleted`) — Fired when a company is deleted</li>
          <li><strong>Account Merged</strong> (`accounts_merged`) — Fired when two companies are merged into one</li>
        </ul>
      </div>
    </Step>

    <Step title="Lead events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to leads (sales opportunities).</p>

        <ul>
          <li><strong>Lead Created</strong> (`leads_created`) — Fired when a new lead is created</li>
          <li><strong>Lead Updated</strong> (`leads_updated`) — Fired when a lead's attributes change (description, value, stage, confidence, outcome, etc.)</li>
          <li><strong>Lead Deleted</strong> (`leads_deleted`) — Fired when a lead is deleted</li>
          <li><strong>Lead Merged</strong> (`leads_merged`) — Fired when two leads are merged into one</li>
        </ul>
      </div>
    </Step>

    <Step title="Activity events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to activities (calls, meetings, tasks).</p>

        <ul>
          <li><strong>Activity Created</strong> (`activities_created`) — Fired when a new activity is scheduled</li>
          <li><strong>Activity Updated</strong> (`activities_updated`) — Fired when an activity's details change (name, description, time, etc.)</li>
          <li><strong>Activity Deleted</strong> (`activities_deleted`) — Fired when an activity is deleted</li>
          <li><strong>Activity Logged</strong> (`activities_logged`) — Fired when an activity is marked as completed</li>
          <li><strong>Activity Cancelled</strong> (`activities_cancelled`) — Fired when a scheduled activity is cancelled</li>
        </ul>
      </div>
    </Step>

    <Step title="Assignment events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to owner/assignee changes on contacts, accounts, or leads.</p>

        <ul>
          <li><strong>Assignment Created</strong> (`assignments_created`) — Fired when an entity is assigned to a user</li>
          <li><strong>Assignment Updated</strong> (`assignments_updated`) — Fired when an assignment is changed to a different user</li>
          <li><strong>Assignment Deleted</strong> (`assignments_deleted`) — Fired when an assignment is removed</li>
        </ul>
      </div>
    </Step>

    <Step title="Note events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to notes on contacts, accounts, or leads.</p>

        <ul>
          <li><strong>Note Created</strong> (`notes_created`) — Fired when a note is added</li>
          <li><strong>Note Updated</strong> (`notes_updated`) — Fired when a note is edited</li>
          <li><strong>Note Deleted</strong> (`notes_deleted`) — Fired when a note is deleted</li>
        </ul>
      </div>
    </Step>

    <Step title="File events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to file attachments on contacts, accounts, or leads.</p>

        <ul>
          <li><strong>File Uploaded</strong> (`files_created`) — Fired when a file is uploaded</li>
          <li><strong>File Deleted</strong> (`files_deleted`) — Fired when a file is deleted</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## 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.