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

# Mailjet Webhook Setup Guide

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

<section data-guide-section data-guide-scopes="">
  <h2>Copy your Native Webhook URL</h2>

  <p>Before configuring Mailjet, copy the <strong>Native Webhook URL</strong> from this connection in StackOne Hub. This is the address Mailjet posts message events to — you will paste it into the <strong>Endpoint URL</strong> field for each event type in the next steps. It is only available after the account has been connected.</p>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Open the Event API page in Mailjet</h2>

  <p>Open the Event notifications (webhooks) page, where Mailjet's message events are configured.</p>

  <Steps>
    <Step title="Open Event notifications from Account Information">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to <a href="https://app.mailjet.com" target="_blank" rel="noopener noreferrer">Mailjet</a>, open the account menu at the top right, and click <strong>Account settings</strong> to open the <strong>Account Information</strong> page. In the <strong>REST API</strong> card, click <strong>Event notifications (webhooks)</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/iMchfBH62SKByHKS/connectors/mailjet/images/events-account-event-notifications.png?fit=max&auto=format&n=iMchfBH62SKByHKS&q=85&s=75656c123f29621f487f6f6126a5efd9" alt="The Account Information page with Event notifications (webhooks) highlighted in the REST API card." width="1280" height="800" data-path="connectors/mailjet/images/events-account-event-notifications.png" />
      </div>
    </Step>

    <Step title="Start a new event">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Event API</strong> page, under <strong>Trigger events</strong>, click <strong>Add a new event</strong>. A new event row appears with an <strong>Event</strong> type selector and an <strong>Endpoint URL</strong> field.</p>

        <img src="https://mintcdn.com/stackone-60/iMchfBH62SKByHKS/connectors/mailjet/images/events-add-a-new-event.png?fit=max&auto=format&n=iMchfBH62SKByHKS&q=85&s=7c700f0108607c0d1d1ae22331f2ee6e" alt="The Event API page with the Add a new event button highlighted." width="1280" height="800" data-path="connectors/mailjet/images/events-add-a-new-event.png" />
      </div>
    </Step>
  </Steps>
</section>

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

  <p>Register the Native Webhook URL for each event type you want to receive. Repeat this for every event — Mailjet stores one endpoint URL per event type.</p>

  <Steps>
    <Step title="Select the event and paste the Native Webhook URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the new row, choose the event from the <strong>Event</strong> selector, then paste your Native Webhook URL into the <strong>Endpoint URL</strong> field.</p>

        <ul>
          <li>Select the event type (for example <strong>Sent</strong>, <strong>Open</strong>, <strong>Click</strong>, <strong>Bounce</strong>, <strong>Blocked</strong>, <strong>Spam</strong>, or <strong>Unsub</strong>) from the <strong>Event</strong> selector.</li>
          <li>Paste your <strong>Native Webhook URL</strong> into the <strong>Endpoint URL</strong> field.</li>
          <li>Leave <strong>Group events</strong> unchecked. StackOne processes one event per request; with grouping enabled Mailjet batches events into a single array, which StackOne does not route.</li>
          <li>Click <strong>Add a new event</strong> again to add another row, and repeat for each event type you want.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/iMchfBH62SKByHKS/connectors/mailjet/images/events-configure-endpoint-url.png?fit=max&auto=format&n=iMchfBH62SKByHKS&q=85&s=266085564b6fb59f99eac769b782576b" alt="An event row on the Event API page with the Endpoint URL field (value redacted) and the Save button highlighted." width="1280" height="800" data-path="connectors/mailjet/images/events-configure-endpoint-url.png" />
      </div>
    </Step>

    <Step title="Save">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Save</strong> to register the callbacks. Mailjet will begin posting the selected events to your Native Webhook URL.</p>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>The following Mailjet message events can be enabled. Register the Native Webhook URL for each event type you want to receive — Mailjet only posts the event types you have configured a callback for.</p>

  <Steps>
    <Step title="Message events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to the delivery and engagement lifecycle of a message.</p>

        <ul>
          <li><strong>Message Sent</strong> (`sent`) — Fired when a message is accepted and delivered to the recipient's mail server.</li>
          <li><strong>Message Opened</strong> (`open`) — Fired when a recipient opens a message (requires open tracking).</li>
          <li><strong>Link Clicked</strong> (`click`) — Fired when a recipient clicks a tracked link in a message (requires click tracking).</li>
          <li><strong>Message Bounced</strong> (`bounce`) — Fired when a message bounces (soft or hard) because the recipient server rejected or could not deliver it.</li>
          <li><strong>Message Blocked</strong> (`blocked`) — Fired when a message is blocked before sending, for example when the recipient address is on a suppression list.</li>
          <li><strong>Spam Complaint</strong> (`spam`) — Fired when a recipient marks a message as spam (a feedback-loop complaint).</li>
          <li><strong>Unsubscribed</strong> (`unsub`) — Fired when a recipient unsubscribes via a message's unsubscribe link.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

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

  <p>How Mailjet delivers events to StackOne.</p>

  <Steps>
    <Step title="One event per request">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Leave <strong>Group events</strong> unchecked so Mailjet posts a single JSON event object per request. StackOne routes each delivery to the matching event handler by its `event` field. With <strong>Group events</strong> enabled, Mailjet batches events into a JSON array, which StackOne does not route — so keep grouping off for StackOne connections.</p>
      </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.