# com.google.appengine.api.mail
Date: 2012-02-24

## Package com.google.appengine.api.mail

App Engine applications can send email messages on behalf of the app's administrators, or of authenticated users, using the standard `javax.mail` interface over this low-level API.

See:
Description

Interface Summary
MailService: The `MailService` provides a way for user code to send emails to arbitrary destinations.

Class Summary
MailService.Attachment
MailService.Header
MailService.Message: Messages are prepared by the caller, and then submitted to the Mail service for sending.
MailServiceFactory: Factory for creating a `MailService`.

## Package com.google.appengine.api.mail Description

App Engine applications can send email messages on behalf of the app's administrators, or of authenticated users, using the standard `javax.mail` interface over this low-level API. Receiving messages is not supported. More information is available in the on-line documentation.

This low-level API is intended primarily for framework authors. For application developers we provide a custom `javax.mail.Transport` that allows the standard `javax.mail` interface to be used to send emails. No special configuration is required to send emails via this interface.

The `MailService.Message` class represents a message, including sender and recipient information, and possibly attachments as `MailService.Attachment` objects. These can be independently created via their respective constructors.

Sending a message requires a `MailService` object, created by the `MailServiceFactory`. Messages are sent asynchronously, so the `MailService` methods will always succeed immediately. Any errors in the mail message will be returned to the sender's address as "bounce" messages.