Mailgun Event Types

Mailgun events are tracked with specific event type IDs in SendPost, allowing you to distinguish between native SendPost events and Mailgun events.

Event Type	ID	Mailgun Event	Description
MG Processed	48	(generated)	Email processed and sent to Mailgun
MG Sent	49	`accepted`	Mailgun accepted the message for delivery
MG Delivered	50	`delivered`	Email successfully delivered to recipient
MG Hard Bounced	51	`failed` (severity: “permanent”)	Permanent delivery failure
MG Soft Bounced	52	`failed` (severity: “temporary”)	Temporary delivery failure
MG Dropped	53	`rejected`	Email rejected by Mailgun
MG Opened	54	`opened`	Recipient opened the email
MG Clicked	55	`clicked`	Recipient clicked a link
MG Spam Report	56	`complained`	Recipient marked email as spam
MG Unsubscribe	57	`unsubscribed`	Recipient unsubscribed

MG Processed (ID 48) is generated by SendPost when the message is successfully submitted to Mailgun, not from a webhook event.

Bounce Type Details

Mailgun categorizes bounces based on the severity field in the failed event:

Hard Bounce (ID: 51)

Permanent failure indicated by severity: "permanent". This includes invalid email addresses, non-existent domains, or permanent rejections. These addresses should be removed from your list.

Soft Bounce (ID: 52)

Temporary failure indicated by severity: "temporary". This includes full mailboxes, temporary server issues, or rate limiting. Mailgun may retry these automatically.

Event Data

Each Mailgun event includes:

Message ID (for correlation)
Recipient email
Timestamp
SMTP response code and message (for bounces)
User agent (for opens)
Client IP address (for opens/clicks)
Clicked URL (for clicks)
Mailgun-specific IDs

Bounce Status Information

Mailgun provides detailed delivery status in the delivery-status field:

Field	Description
`code`	SMTP response code (integer)
`message`	SMTP response message (string)

Example SMTP Codes:

Code	Meaning
250	Success
421	Service temporarily unavailable
450	Mailbox temporarily unavailable
452	Insufficient storage
550	Mailbox unavailable (permanent)
551	User not local
552	Exceeded storage allocation
553	Mailbox name invalid
554	Transaction failed

Event Type Quick Reference

Event	ID	Mailgun Webhook Event
Processed	48	(generated internally)
Sent	49	`accepted`
Delivered	50	`delivered`
Hard Bounce	51	`failed` (permanent)
Soft Bounce	52	`failed` (temporary)
Dropped	53	`rejected`
Open	54	`opened`
Click	55	`clicked`
Spam	56	`complained`
Unsubscribe	57	`unsubscribed`

Next Steps

View analytics to see event statistics
Troubleshoot issues with event processing