Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Amazon SES header fields

PDF
Focus mode
Amazon SES header fields - Amazon Simple Email Service

Amazon SES can accept all email headers that follow the format described in RFC 822.

The following fields can't appear more than once in the header section of a message:

  • Accept-Language

  • acceptLanguage

  • Archived-At

  • Auto-Submitted

  • Bounces-to

  • Comments

  • Content-Alternative

  • Content-Base

  • Content-Class

  • Content-Description

  • Content-Disposition

  • Content-Duration

  • Content-ID

  • Content-Language

  • Content-Length

  • Content-Location

  • Content-MD5

  • Content-Transfer-Encoding

  • Content-Type

  • Date

  • Delivered-To

  • Disposition-Notification-Options

  • Disposition-Notification-To

  • DKIM-Signature

  • DomainKey-Signature

  • Errors-To

  • From

  • Importance

  • In-Reply-To

  • Keywords

  • List-Archive

  • List-Help

  • List-Id

  • List-Owner

  • List-Post

  • List-Subscribe

  • List-Unsubscribe

  • List-Unsubscribe-Post

  • Message-Context

  • Message-ID

  • MIME-Version

  • Organization

  • Original-From

  • Original-Message-ID

  • Original-Recipient

  • Original-Subject

  • Precedence

  • Priority

  • References

  • Reply-To

  • Return-Path

  • Return-Receipt-To

  • Sender

  • Solicitation

  • Sensitivity

  • Subject

  • Thread-Index

  • Thread-Topic

  • User-Agent

  • VBR-Info

Considerations

  • The acceptLanguage field is non-standard. If possible, you should use the Accept-Language header instead.

  • If you specify a Date header, Amazon SES overrides it with a timestamp that corresponds to the date and time in the UTC time zone when Amazon SES accepted the message.

  • If you provide a Message-ID header, Amazon SES overrides the header with its own value.

  • If you specify a Return-Path header, Amazon SES sends bounce and complaint notifications to the address that you specified. However, the message that your recipients receive contains a different value for the Return-Path header.

  • If you use the Amazon SES API v2 SendEmail operation with either Simple or Templated content, or use the SendBulkEmail operation, you cannot set custom header content for headers that are set by SES; therefore, the following headers are disallowed as custom headers:

    • BCC, CC, Content-Disposition, Content-Type, Date, From, Message-ID, MIME-Version, Reply-To, Return-Path, Subject, To

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.