Mailgun

Use Mailgun to send text or HTML emails, retrieve messages and delivery events, manage mailing lists, and inspect sending domains. Tags help associate sent messages with a workflow or campaign.

Use the block

Send text or HTML emails, manage mailing lists and members, inspect domains, and track email events with tags.

Actions

Mailgun Send Message

Send an email using Mailgun API

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
domain	string	Yes	Mailgun sending domain (e.g., mg.example.com)
from	string	Yes	Sender email address (e.g., sender@example.com or "Name <sender@example.com>")
to	string	Yes	Recipient email address (e.g., user@example.com). Use comma-separated values for multiple recipients
subject	string	Yes	Email subject line
text	string	No	Plain text body of the email
html	string	No	HTML body of the email (e.g., "<h1>Hello</h1><p>Message content</p>")
cc	string	No	CC recipient email address (e.g., cc@example.com). Use comma-separated values for multiple recipients
bcc	string	No	BCC recipient email address (e.g., bcc@example.com). Use comma-separated values for multiple recipients
tags	string	No	Tags for the email (comma-separated)

Output

Parameter	Type	Description
success	boolean	Whether the message was sent successfully
id	string	Message ID
message	string	Response message from Mailgun

Mailgun Get Message

Retrieve a stored message by its key

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
domain	string	Yes	Mailgun domain for retrieving messages (e.g., mg.example.com)
messageKey	string	Yes	Message storage key

Output

Parameter	Type	Description
success	boolean	Whether the request was successful
recipients	string	Message recipients
from	string	Sender email
subject	string	Message subject
bodyPlain	string	Plain text body
strippedText	string	Stripped text
strippedSignature	string	Stripped signature
bodyHtml	string	HTML body
strippedHtml	string	Stripped HTML
attachmentCount	number	Number of attachments
timestamp	number	Message timestamp
messageHeaders	json	Message headers
contentIdMap	json	Content ID map

Mailgun List Messages

List events (logs) for messages sent through Mailgun

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
domain	string	Yes	Mailgun domain for listing events (e.g., mg.example.com)
event	string	No	Filter by event type (accepted, delivered, failed, opened, clicked, etc.)
limit	number	No	Maximum number of events to return (default: 100)

Output

Parameter	Type	Description
success	boolean	Whether the request was successful
items	json	Array of event items
paging	json	Paging information

Mailgun Create Mailing List

Create a new mailing list

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
address	string	Yes	Mailing list address (e.g., newsletter@mg.example.com)
name	string	No	Mailing list name
description	string	No	Mailing list description
accessLevel	string	No	Access level: readonly, members, or everyone

Output

Parameter	Type	Description
success	boolean	Whether the list was created successfully
message	string	Response message
list	json	Created mailing list details

Mailgun Get Mailing List

Get details of a mailing list

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
address	string	Yes	Mailing list address to retrieve (e.g., newsletter@mg.example.com)

Output

Parameter	Type	Description
success	boolean	Whether the request was successful
list	json	Mailing list details

Mailgun Add List Member

Add a member to a mailing list

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
listAddress	string	Yes	Mailing list address (e.g., list@mg.example.com)
address	string	Yes	Member email address to add (e.g., user@example.com)
name	string	No	Member name
vars	string	No	JSON string of custom variables
subscribed	boolean	No	Whether the member is subscribed

Output

Parameter	Type	Description
success	boolean	Whether the member was added successfully
message	string	Response message
member	json	Added member details

Mailgun List Domains

List all domains for your Mailgun account

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"

Output

Parameter	Type	Description
success	boolean	Whether the request was successful
totalCount	number	Total number of domains
items	json	Array of domain objects

Mailgun Get Domain

Get details of a specific domain

Inputs and outputs

Input

Parameter	Type	Required	Description
apiKey	string	Yes	Mailgun API key
region	string	No	Mailgun account region: "us" (default) or "eu"
domain	string	Yes	Domain name to retrieve details for (e.g., mg.example.com)

Output

Parameter	Type	Description
success	boolean	Whether the request was successful
domain	json	Domain details