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

# Postmark Webhook Setup Guide

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

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

  <p>No configuration is required in Postmark. When you connect your account, StackOne creates the webhook on your server and removes it when you disconnect.</p>

  <Steps>
    <Step title="One webhook is created">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>A single webhook is registered on the server's outbound (Transactional) message stream, subscribed to the events you selected in StackOne.</p>
      </div>
    </Step>

    <Step title="Enable tracking for open and click events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Open and Click are delivered only for messages sent with tracking enabled. Turn it on per message using the `TrackOpens` and `TrackLinks` parameters, or set a default for the whole server under Servers > \[Your Server] > Settings > <strong>Tracking</strong>.</p>

        <ul>
          <li>Messages sent without `TrackOpens` never produce an <strong>Open</strong> event.</li>
          <li>Messages sent without `TrackLinks` never produce a <strong>Click</strong> event, because Postmark detects clicks by rewriting the links in the message.</li>
          <li>Only a recipient's first open of a message is delivered. Subsequent opens of the same message are not.</li>
        </ul>
      </div>
    </Step>

    <Step title="Do not edit or delete it in Postmark">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The webhook appears under Servers > \[Your Server] > Webhooks. Changing or removing it there stops all event delivery until the account is reconnected.</p>
      </div>
    </Step>

    <Step title="Connect each server separately">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>To receive events from more than one Postmark server, connect each one as a separate StackOne account, using its own Server API Token.</p>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>The events below can be enabled for this connection. Only events selected in StackOne are delivered.</p>

  <Steps>
    <Step title="Delivery outcome events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events describing what happened to a message after it was sent.</p>

        <ul>
          <li><strong>Delivery</strong> (`Delivery`) — Fired when the recipient's mail server accepts the message</li>
          <li><strong>Bounce</strong> (`Bounce`) — Fired when a message cannot be delivered, covering hard bounces, soft bounces and transient failures</li>
          <li><strong>Spam Complaint</strong> (`SpamComplaint`) — Fired when a recipient marks a message as spam</li>
        </ul>
      </div>
    </Step>

    <Step title="Engagement events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events describing how a recipient interacted with a message. Both are delivered only for messages sent with open or link tracking enabled.</p>

        <ul>
          <li><strong>Open</strong> (`Open`) — Fired the first time a recipient opens a tracked message</li>
          <li><strong>Click</strong> (`Click`) — Fired when a recipient clicks a tracked link in a message</li>
        </ul>
      </div>
    </Step>

    <Step title="Suppression events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events describing changes to whether an address can be sent to.</p>

        <ul>
          <li><strong>Subscription Change</strong> (`SubscriptionChange`) — Fired when an address is suppressed or reactivated, whether by a hard bounce, a spam complaint or a manual suppression you create</li>
        </ul>
      </div>
    </Step>

    <Step title="Inbound email">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p><strong>Inbound Email</strong> (`Inbound`) is available on this connector but is not covered by the automatic setup. Postmark configures inbound processing through the server's inbound webhook URL rather than the Webhooks API, so StackOne cannot create it for you.</p>

        <ul>
          <li>To receive inbound events, set the Native Webhook URL manually under Servers > \[Your Server] > Settings > Inbound.</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.