View as Markdown
Mailgun icon

Mailgun TRIGGER

New Delivery Failure (Instant)

Emit new event when an email can't be delivered to the recipient email server.
  • Trigger
  • Instant
  • API key
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Mailgun account, configure the source, and choose the webhook where your backend receives events.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "mailgun-new-delivery-failure",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mailgun: { authProvisionId: "apn_xxxxxxx" },
    domain: "Domain Name",
    webhookSigningKey: "Mailgun webhook signing key",
  },
  webhookUrl: "https://example.com/webhooks/mailgun",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New Delivery Failure (Instant) configuration
Property Type Description
domain Domain Name string
Required Dynamic
webhookSigningKey Mailgun webhook signing key string
Your Mailgun webhook signing key, found in your Mailgun dashboard, located under Settings on the left-hand nav and then in API Keys look for webhook signing key. Required to compute the authentication signature of events.
Required

01

Connect

Your user authorizes Mailgun through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — as it happens.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
mailgun-new-delivery-failure
Version
0.0.2
App
Mailgun
Authentication
API key
Delivery
Instant event
Output
Events emitted by Mailgun.