Mailjet trigger

Overview

Receives webhook notifications from Mailjet when email delivery events occur, such as messages sent, opened, clicked, bounced, marked as spam, blocked, or unsubscribed. Mailjet sends POST requests to the registered callback URL with an array of event objects containing the event type, timestamp, message ID, and recipient email. The trigger registers itself with Mailjet’s Event Callback URL API (POST /v3/rest/eventcallbackurl) for the selected event type. Useful for tracking email delivery, monitoring bounces and spam reports, automating re-engagement workflows on opens/clicks, and handling unsubscribe events. Authenticates via HTTP Basic Auth using the Mailjet API Key and Secret Key. WARNING: Mailjet does not sign webhook payloads. Security relies on the secrecy of the registered callback URL. Do not commit it to public repos or share publicly.

Node Type

Trigger — webhook (receives incoming HTTP callbacks)

Input / Output

Direction	Port(s)
Input	None (trigger node)
Output	Output

Credentials

This tool requires Mailjet Email credentials. See the Credentials Guide for setup instructions.

Parameters

Parameter	Type	Required	Default	Description
Event	options	Yes	open	Which email event type to listen for. Determines which Mailjet event callback is registered.
				Options: blocked (email.blocked), bounce (email.bounce), open (email.open), sent (email.sent), spam (email.spam), unsub (email.unsub)

Output Data

Mailjet posts an array of event objects, and each entry becomes its own output item. Every item carries three metadata fields plus the event’s own fields:

• _trigger — always mailjet_webhook
• _timestamp — ISO 8601 timestamp of when the request arrived
• _webhookEvent — the Mailjet event name taken from the payload
• event — the Mailjet event name
• time — the Unix timestamp Mailjet recorded for the event
• MessageID, Message_GUID — identifiers for the message the event belongs to
• email — the recipient address
• mj_campaign_id, mj_contact_id, customcampaign, CustomID, Payload — Mailjet campaign, contact and custom-tracking identifiers
• ip, geo, agent, url — client and link details recorded for open and click events
• blocked, hard_bounce, error_related_to, error — delivery failure details
• source — the source Mailjet attributes the event to

Any other field Mailjet includes in the event is merged in alongside these. Reference the result downstream by expression, e.g. {{ $json.email }}.

Example Configuration

Listen for message opens:

{
  "type": "mailjet_trigger",
  "parameters": {
    "event": "open"
  }
}

Listen for bounces so you can clean your list:

{
  "type": "mailjet_trigger",
  "parameters": {
    "event": "bounce"
  }
}

Listen for unsubscribes:

{
  "type": "mailjet_trigger",
  "parameters": {
    "event": "unsub"
  }
}

Trigger Behavior

• Activation: When the workflow is activated, a webhook endpoint is registered with the service.
• Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
• Payload: The incoming webhook payload is parsed and output as workflow items.
• Verification: Supports signature verification where applicable.

Tips

This tool detects Mailjet email events like opens, clicks, or bounces. It is the right tool when you need to start a workflow based on specific email delivery statuses from Mailjet. It produces an event object for each detected email event, containing details like the event type, timestamp, message ID, and recipient email.