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

# Nmbrs Webhook Setup Guide

> Configure Nmbrs to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](/connectors/nmbrs#getting-started) on the Nmbrs connector page.

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

  <p>Nmbrs does not expose a webhook API on the REST platform this connector uses, so the webhook is registered by hand in Nmbrs. Paste the StackOne Native Webhook URL into a new webhook setting and enable the event you want.</p>

  <Steps>
    <Step title="Copy the Native Webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Open the linked account in StackOne Hub and copy the <strong>Native Webhook URL</strong> field.</p>

        <ul>
          <li>The field is read-only and is only available after the integration has been created.</li>
          <li>The URL is unique to this connected account — it is how StackOne attributes inbound events, so do not reuse it on another account.</li>
        </ul>
      </div>
    </Step>

    <Step title="Open Webhook Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In Nmbrs, go to <strong>Settings</strong> → <strong>Integration</strong> → <strong>Webhook Settings</strong>, then select <strong>New Webhook Settings</strong>.</p>

        <ul>
          <li>Existing webhook settings are listed with their <strong>Name</strong> and <strong>Endpoint</strong>.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/EItQlESoX4hBO-3A/connectors/nmbrs/images/events-webhook-settings.png?fit=max&auto=format&n=EItQlESoX4hBO-3A&q=85&s=a5a2dbb37302291d09e03df2b4272b28" alt="Nmbrs Webhook Settings page listing configured webhooks with the New Webhook Settings button." width="1280" height="800" data-path="connectors/nmbrs/images/events-webhook-settings.png" />
      </div>
    </Step>

    <Step title="Create the webhook setting">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Complete the <strong>Webhook Settings</strong> dialog, then select <strong>Save</strong>.</p>

        <ul>
          <li><strong>Name:</strong> — a name to identify the setting, for example `StackOne`.</li>
          <li><strong>Endpoint:</strong> — paste the <strong>Native Webhook URL</strong> you copied from StackOne Hub.</li>
          <li><strong>Active:</strong> — select this checkbox to turn the webhook on.</li>
          <li>Set <strong>Run Finish</strong> to <strong>Active</strong>.</li>
          <li>Leave every other event set to <strong>Not active</strong> — StackOne only handles <strong>Run Finish</strong>, and other events are rejected.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/EItQlESoX4hBO-3A/connectors/nmbrs/images/events-create-webhook.png?fit=max&auto=format&n=EItQlESoX4hBO-3A&q=85&s=8ede612e6ef61ccc7f33fc89fbffbbc2" alt="Webhook Settings dialog with the Name, Endpoint and Active fields and the list of selectable events." width="1280" height="800" data-path="connectors/nmbrs/images/events-create-webhook.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available webhook events</h2>

  <p>Nmbrs offers six webhook events. Only the event selected below is handled by StackOne — enabling the others causes Nmbrs to deliver events that are rejected, which shows as failed deliveries on the Nmbrs side.</p>

  <Steps>
    <Step title="Payroll run events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events raised when payroll processing completes for a company.</p>

        <ul>
          <li><strong>Run Finish</strong> (`run.finish`) — Fired when a payroll run is finished. It applies to all run types, including normal, retro-active correction and pre-run. Use it to refresh payroll runs, the company's current period, payslips and payroll documents.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Delivery format</h2>

  <p>Details of how Nmbrs delivers events to StackOne.</p>

  <Steps>
    <Step title="One request per event">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Nmbrs sends each event as a separate request. The payload identifies the company and the run, but carries no payroll data — follow the event with a read action to fetch the detail.</p>

        <ul>
          <li>Nmbrs sends no signature, shared secret or verification request. The per-account Native Webhook URL is the only credential, so treat it as a secret.</li>
          <li>Finishing a payroll run also raises <strong>Journals Finish</strong> a few seconds earlier. StackOne does not handle it, so leave it set to <strong>Not active</strong>.</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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.