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