View as Markdown
Mailgun icon

Mailgun ACTION

Send Email

Send email with Mailgun. See the docs here
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mailgun account once, then configure and run Send Email from your backend or agent.

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 result = await pd.actions.run({
  id: "mailgun-send-email",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mailgun: { authProvisionId: "apn_xxxxxxx" },
    domain: "Domain Name",
    fromName: "From Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Send Email inputs
Property Type Description
domain Domain Name string
Required Dynamic
fromName From Name string
Sender name
Required
from From Email string
Sender email address
Required
replyTo Reply-To string
Sender reply email address
Optional
to To string[]
Recipient email address(es)
Required
subject Subject string
Message subject
Required
text Message Body (text) string
Optional
html Message Body (HTML) string
Optional
attachments Attachments object
Add any attachments you'd like to include as objects. The key should be the filename and the value should be the url download link for the attachment.
Optional
testMode Send in test mode? boolean
Enables sending in test mode. For more information, see the Mailgun API documentation
Required
dkim Use DKIM? boolean
Enables or disables DKIM signatures. For more information, see the Mailgun API documentation
Optional
tracking Use Tracking? boolean
Enables or disables tracking. For more information, see the Mailgun API documentation
Optional
haltOnError Halt on error? boolean
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mailgun-send-email
Version
0.1.1
App
Mailgun
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes