# Mailgun > This section describes our RESTful API for alert configuration for Mailgun Optimize. ## Pages - [Alerts](alerts-ir.md): This section describes our RESTful API for alert configuration for Mailgun Optimize. - [Send Alerts](alerts-send.md): Get instant notifications on the sending metrics that matter most, configured specifically for your unique business n... - [API Overview](api-overview.md): All API calls referenced in our documentation start with a base URL. Mailgun allows the ability to send and receive e... - [Authentication](auth-bestpractice.md): It is very important that you are using the appropriate authentication - [Batch Sending](batch-sending.md): Mailgun supports the ability to send to a group of recipients through a single API call, or SMTP session. - [Email Best Practices 📧](best-practices.md): After managing email servers for thousands of customers, both sending and recieiving, we have learned these best prac... - [Bounce and MBP Feedback Handling](bounce-esp.md): A big part of maintaining your email reputation is processing bounces properly. While most major MBPs (Mailbox Provid... - [Bulk Validation](bulk-valid-ir.md): Note: - [Bulk_Valid_Preview](bulk-valid-preview.md): List Health Preview performs a free analysis of a list of email addresses allowing you to make an informed decision t... - [FAQ: Deliverability / Reputation](deliver-rep.md): The way to think about your email reputation is much like your credit - [Developer Tools](developer-tools.md): Import all Mailgun APIs into Postman for easy testing and integration. Our public workspace includes organized collec... - [Dimensions](dimensions.md): | Dimension | API Variable Name | Example Values | Description | - [DKIM Security](dkim-security.md): DKIM (DomainKeys Identified Mail) security involves regularly updating the cryptographic keys used for signing emails... - [DNS](dns.md): Your email reputation is not only tied to your IP, but your domain name as well. You should keep this in mind as you ... - [Domain Blocklist Monitoring](domain-blocklist-ir.md): [Blocklist Monitoring](https://www.mailgun.com/products/inbox/deliverability/blocklist-monitoring-service/) enables y... - [Custom Domains](domains-custom.md): Creating custom domains in Mailgun enables you to send emails through your own domain instead of relying on the defau... - [Domains](domains-ir.md): This section describes domain management for Sinch Optimize products. Use these APIs to register domains for domain-b... - [Sandbox Domain](domains-sandbox.md): Want to immediately send email from your account without setting up your own Domain? - [Domain Verification](domains-verify.md): - To prove you are an authorized sender for the domain - [Domains](domains.md): When emails are sent, they are transmitted through domains over the internet. An email address has two main parts: th... - [Email Preview](email-preview-ir.md): Our Email Preview service allows you to see how your emails render across various web, desktop, and mobile clients. - [Email Validation API](email-valid-ir.md): Note: - [Email Content](email-content.md): There are a few tricks to remember about content besides the mantra of - [Event Polling](event-polling.md): In our system, events are generated by physical hosts and follow different routes to the event storage. Therefore, th... - [Event Samples](event-samples.md): Response Samples of various Event types can be found on the Events API Reference page. - [Event Structure](event-structure.md): Events are represented as loosely structured JSON documents. The exact event structure depends on the event type. But... - [Event Types](event-types.md): Mailgun tracks all of the events that occur throughout the system. Below are listed the events that you can retrieve ... - [Introduction to Events](events.md): Mailgun retains event data for 30 days. Access to this data varies by plan. Refer to our [Pricing page](https://www.m... - [FAQ: Getting Started/ Settings](faqs.md): You can but you should be aware that there is a constant battle raging - [Feedback Loops and Spam Complaints](feedbackloops.md): Most of the major MBPs (Mailbox Providers) other than Gmail provide feedback loops through which they give you inform... - [Filter Expression](filter-expressions.md): Possible filtering expressions are listed below: - [Filter Field](filter-field.md): Log Records can be filtered by the following fields: - [Welcome to Mailgun](get-started.md): Mailgun provides powerful APIs and tools to send, receive, and track emails at scale. Whether you're building transac... - [Golang](go-sdk.md): a - [Hosting](hosting.md): Mailgun is mostly hosted on dedicated servers, however we use cloud servers for - [Inbox Placement](inbox-placement-ir.md): A seed list is an object that provides the mailing list for your inbox placement test. It also acts as a container fo... - [Alerts](inboxready.md): Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configu... - [Internationalization](internationalization.md): Internationalization Domain Names (IDN) - [Mailgun Optimize User's Guide](intro-ir.md): This section documents the API endpoints that support features under the [Mailgun Optimize](https://www.mailgun.com/p... - [Mailgun User Manual 📚](intro.md): The Mailgun User Manual is your comprehensive guide to using Mailgun's email platform. It covers everything you need ... - [SDKs](introduction.md): Mailgun offers a variety of SDKs designed to simplify email integration for developers. Our SDKs support multiple pro... - [IP Blocklist Monitoring](ip-blocklist-ir.md): [Blocklist Monitoring](https://www.mailgun.com/products/inbox/deliverability/blocklist-monitoring-service/) enables y... - [IP Addresses and Sending Volume](ip-address.md): Mailgun offers both shared and dedicated IPs. We are constantly monitoring the traffic on these IPs, so even for shar... - [Java](java-sdk.md): a - [How to lower your bounce rate](lower-bounce-rate.md): Mailgun has thresholds in place that if exceeded will result in a domain - [Mailboxes {#api-mailboxes}](mailboxes.md): Mailgun Mailbox API allows you to programmatically create as many - [Mailgun API](mailgun.md): Mailgun API defined by OpenAPI Specification (OAS) 3.1.0 - [Mailing Lists](mailing-lists.md): Mailing Lists are a great way to send to multiple recipients while using an email alias. When you use mailing lists, ... - [Mailing Lists](mailinglists.md): The number one reason we see people getting blocked is due to them having a bad mailing list. You should only send em... - [Message Queue](message-queue.md): The queuing algorithms are one of the most important features of Mailgun. If you try sending bulk mailings all at onc... - [Metric Definitions](metric-definitions.md): Mailgun's Metrics API offers endpoints to access summarized data, including counts, rates, and dimensions. It support... - [Authentication](mg-auth.md): Authentication to the Mailgun API is done by providing an Authorization header using [HTTP Basic Auth:](http://en.wik... - [Reporting Overview](mg-reporting.md): Mailgun's Reporting Dashboard provides a quick and easy way to view your sending metrics and reports. You can view re... - [Node.js](nodejs-sdk.md): a - [Mailgun Optimize APIs Overview](onboarding-ir.md): Mailgun Optimize by Sinch is a suite of deliverability tools and services that help take the complexity out of email ... - [Open and Click Bot Detection](open-click-bot-detect.md): Mailgun uses tracking pixels and URL redirects to track when a user opens the message and clicks links in the email. ... - [Alerts](openapi-final.md): Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configu... - [Validations Service](openapi-validate-final.md): Mailgun Email Validation service with RESTful JSON HTTP API for performing email validation. This service also manage... - [Mailgun Inspect: Your Email Pre-Send Quality Control Solution](overview.md): Mailgun Inspect is an email pre-send quality control tool that ensures your emails are optimized for delivery, readab... - [Pass Sending Options](pass-sending-options.md): When sending emails there are a variety of sending options to consider. See the table below: - [PHP](php-sdk.md): a - [Python](python-sdk.md): a - [Query Options](query-options.md): URL parameters allow you to manipulate the results of your query. - [Quickstart: Send Your First Email](quickstart.md): Send an email in under two minutes using your sandbox domain - [Rate Definitions](rate-definitions.md): html - [Razor Error Codes](razor.md): Razor is Mailgun's reputation system for detecting spammers and - [API Management and Security](rbac-mgmt.md): Email API keys provide secure access to email services and data. They enable access to our APIs and allow integrating... - [Introduction to Receiving, Forwarding and Storing Messages](receive-forward-store.md): Mailgun will allow you to receive emails sent to your Mailgun Domain using the Routes feature, which will perform act... - [Receive Http](receive-http.md): When a URL is specified as a route destination through a forward() action, Mailgun will perform an HTTP POST request ... - [FAQ: Receiving](receiving.md): Yes. Click on your domain in the [Control - [Recipient Engagement](recipient-eng.md): In addition to processing bounces, complaints and unsubscribes, MBPs (Mailbox Providers) - [Release Notes](release-notes.md): Release notes refers to recent changes, feature enhancements, or bug fixes. You can find out what's new or check for ... - [Reputation](reputation.md): Reputation is one of the most important assets you have, even when sending email. If you do not have a good reputatio... - [Require tls](require-tls.md): TLS sending connection settings ensure your emails are securely transmitted by encrypting the connection between your... - [Route Actions](route-actions.md): If a route expression is evaluated to *true,* Mailgun executes the corresponding action. Currently you can use the fo... - [Route Filters](route-filters.md): Route filters are expressions that decide when an action is triggered. A filter is created based on the recipient of ... - [Routes](routes.md): You can define a list of routes to handle incoming emails. This idea of routes is borrowed from MVC web frameworks li... - [Ruby](ruby-sdk.md): a - [Scheduling Delivery](schedule-delivery.md): Mailgun allows you to request a specific time for delivering messages. - [Sending an AMP Message](send-amp.md): Google's Accelerated Mobile Pages (AMP) for email is a web component framework that you can use to easily create user... - [Send via HTTP](send-http.md): When sending an email via HTTP on our platform, Mailgun offers two options: - [Swaks is the cURL equivalent for SMTP, install it first:](send-smtp.md): First you'll need to grab your SMTP credentials (user and password). - [Sending a Message with STO](send-sto.md): Mailgun's **Send Time Optimization** (STO) feature uses machine learning to analyze engagement data (opens and clicks... - [Templates](send-templates.md): Mailgun allows you to store predefined email templates and use them to send messages by simply referencing the templa... - [Send Tzo](send-tzo.md): Time Zone Optimization (TZO) allows senders to schedule messages to be delivered in a recipient's local time zone. TZ... - [Sending Messages](sending-messages.md): Info - [FAQ: Sending](sending.md): It's really up to you. Whatever you find easier is fine with us. The - [Single Validation](single-valid-ir.md): Info - [Skip verification](skip-verification.md): The skip verification option in TLS sending connection settings allows you to bypass certificate validation during em... - [SMTP Protocol Introduction](smtp-protocol.md): In addition to the HTTP API, Mailgun servers also support the standard SMTP protocol. You can send email using SMTP w... - [SMTP Relay](smtp-relay.md): You can configure your own mail server to relay mail via Mailgun (example below). To do so, you will need the followi... - [Spam Filter](spam-filter.md): A spam filter is necessary when receiving email. Mailgun is powered by an army of SpamAssassin machines. Mailgun give... - [Spam Trap Monitoring](spam-trap-ir.md): Our [spam trap monitoring](https://help.mailgun.com/hc/en-us/articles/4413151071515-What-are-Spam-Traps) service surf... - [Using Standard Email Clients](standard-email-clients.md): Standard email clients like Thunderbird or Outlook can also be used to send mail. - [Storing and Retrieving Messages](store-retreive.md): When storing an email through a store() action in a Route, you can choose to be notified when the message is stored b... - [Storing and Retrieving Messages](storing-and-retrieving-messages.md): When storing an email through a store() action in a Route, you can choose to be notified when the message is stored b... - [Summary of Subaccount Features](subaccounts-features.md): As the primary account, you will have the ability to: - [Subaccounts and IP Pools](subaccounts-ip-pools.md): As a primary account admin you can manage the IP Pools that will be used by your subaccounts in one of three ways. - [Terminology](subaccounts-terms.md): | Term | Definition | - [Subaccounts Overview](subaccounts.md): Mailgun’s subaccount functionality allows account admins and developers the ability to create and manage a new Mail... - [Sending in Test Mode](test-mode.md): You can send messages in test mode by setting the`o:testmode`parameter to either`yes`or`true`. When you do this,... - [Time Range](time-range.md): When making a request, you need to specify a time range, which consists of a starting timestamp. Additionally, you mu... - [TLS Sending Connection Settings](tls-sending.md): Mailgun exposes flags for mail delivery that will work at the Domain or per Message level. This allows you to control... - [Stats](track-stats.md): You can view stats aggregated by tag within the Analytics portion of the Mailgun UI. Additionally the [Stats API](htt... - [Tags](track-tagging.md): Mailgun allows you to tag your email with unique identifiers. They can help segment your email into relevant categori... - [Tracking Clicks](tracking-clicks.md): Mailgun can track every time a recipient clicks on a link included in your email. When you enable Click tracking, lin... - [Tracking Deliveries](tracking-deliveries.md): Mailgun tracks all successful deliveries that occur when the recipient email server responds that it has accepted the... - [Tracking Failures](tracking-failures.md): Mailgun tracks all delivery failures, which consists of both hard bounces (permanent failures), and soft bounces (tem... - [Introduction to Email Events](tracking-messages.md): Mailgun provides comprehensive email tracking tools that offer insights through **Events**, **Stats**, and **Tagging*... - [Tracking Opens](tracking-opens.md): Mailgun uses tracking pixels and URL redirects to track every time a recipient opens a message. These events can be v... - [Tracking Spam Complaints](tracking-spam-complaints.md): Email service providers (ESP) are very sensitive to users clicking on spam complaint buttons. It's important to monit... - [Tracking Unsubscribes](tracking-unsubscribes.md): Mailgun will automatically prevent future emails from being sent to recipients who have unsubscribed when you enable ... - [FAQ: Tracking](tracking.md): Yep, Mailgun tracks all of the typical events that occur with emails: - [Unsubscribe Handling](unsubscribe.md): It is important to give your recipients the ability to unsubscribe from emails. First, it is required by the [CAN-Spa... - [Engagement Validation](validate-engagement.md): Validate’s engagement results are a macro-level view that explain an email recipient’s propensity to engage. For ... - [output filename](view-stored-messages.md): To access the contents of the stored messages (including raw MIME) you'll need the email's storage URL. This can be f... - [Webhooks](webhooks.md): Webhooks allows you to programmatically handle events that happen with your messages sent through Mailgun. By config...