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

# ShipStation Webhook Setup Guide

> Configure ShipStation 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/shipstation#getting-started) on the ShipStation connector page.

<section data-guide-section data-guide-scopes="">
  <h2>How ShipStation webhooks are set up</h2>

  <p>StackOne creates and manages the ShipStation webhook subscriptions automatically when the account is connected, and removes them when it is disconnected. There is nothing to configure in ShipStation and no URL to paste.</p>

  <ul>
    <li>StackOne subscribes one ShipStation webhook per event you enable, because each ShipStation webhook covers a single event.</li>
    <li>Webhooks cover every store on the account.</li>
    <li>The API Key and API Secret used for the connection must belong to a plan with V1 API access (Standard plan or higher).</li>
  </ul>
</section>

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

  <p>The following ShipStation events can be enabled. Only events selected in StackOne are subscribed, and ShipStation does not send events that are not subscribed.</p>

  <Steps>
    <Step title="Order events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to new orders created in or imported into ShipStation.</p>

        <ul>
          <li><strong>Order Notify</strong> (`ORDER_NOTIFY`) — Fired when new orders are created in or imported into ShipStation</li>
          <li><strong>Item Order Notify</strong> (`ITEM_ORDER_NOTIFY`) — Fired when new orders are created in or imported into ShipStation, with the batch resource including each order's line items</li>
        </ul>
      </div>
    </Step>

    <Step title="Shipment events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to shipped orders.</p>

        <ul>
          <li><strong>Ship Notify</strong> (`SHIP_NOTIFY`) — Fired when orders ship with a shipping label</li>
          <li><strong>Item Ship Notify</strong> (`ITEM_SHIP_NOTIFY`) — Fired when orders ship with a shipping label, with the batch resource including each shipment's line items</li>
        </ul>
      </div>
    </Step>

    <Step title="Fulfillment events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to orders shipped outside ShipStation labels, by marking them as shipped or through a fulfillment provider.</p>

        <ul>
          <li><strong>Fulfillment Shipped</strong> (`FULFILLMENT_SHIPPED`) — Fired when an order is marked as shipped without a ShipStation label, including orders shipped by a fulfillment provider</li>
          <li><strong>Fulfillment Rejected</strong> (`FULFILLMENT_REJECTED`) — Fired when a fulfillment provider rejects an order sent to it</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>ShipStation sends a notification, not the records themselves.</p>

  <ul>
    <li>Each delivery contains only `resource_url` and `resource_type`, which holds the event code. The `resource_url` is a batch URL that returns the affected orders, shipments or fulfillments.</li>
    <li>Request the `resource_url` with the same ShipStation API Key and API Secret to fetch the records. One notification can cover several records imported or shipped together.</li>
    <li>ShipStation does not include a timestamp or a signature in the delivery.</li>
  </ul>
</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.